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INTRODUCTION 

The COMMODORE 64 PROGRAMMER'S REFERENCE GUIDE has been 
developed as a working tool and refe r ence source fcr Those of ycL who 
wort to maximize your use cf ihe built-in capabi irtcs of your COMMO- 
DORE 64, This manual contains the rformcnion you need for your pro- 
grams, from the simplest cxcmple all the way to the most complex. The 
PROGRAMMER'S REFERENCE GUIDE is designed so thcr everyone from 
the beginning BASIC programmer to the professional experienced in 
6502 machine language can get inlormcjlluti lo develop hi* or her own 
creative programs. At the same time rhis book shows you how clever 
your COMMODORE 64 really is. 

This REFERENCE GUIDE is not designed to teach the BASIC pro- 
g-amning langucge or the 6502 machine language. There is, however, 
an extensive glossary of terms and a "semi-tutorial" aporoach to many 
of the sections in tne book. If you don't olrcady have a working knowl- 
edge of BASIC and hew to use il ro program,, we suggest that you study 
the COMMODORE 64 USER'S GUIDE that come with yojr computer. The 
USER'S GUIDE gives you an easy to rend int rod ul lion lo Ihe BASIC pro- 
gramming language. It you still have difficulty understanding how to jse 
BASIC then turn to the back of this book (or Appendk N in the USER'S 
GUIDE) and check out the Bibliography. 

The COMMODORE 64 PROGRAMMER'S REFERENCE GUIDE is jest 
that; a referpne^ Like most reference books, your aoility -o apply the 
information creatively really depends on how much knowledge you have 
aoout the suoject. In other words if you are a novice programmer you 
will not be oble to use all the -acts and figures V. th's book until you 
expand your current prcgramming knowledge. 

Ix 



What you car do with this book is to -Ind 3 considerable amount of 
valuable programming reference information wrrrten in cosy to read, 
plain English with the programmer's jargon explained. On (he other 
hand the programming professional will find all the information needed 
to use the capabilities of the COMMODORE 64 effectively. 

WHAT'S INCLUDED? 

• Our complete 'BASIC dictionary" includes Commodore BASIC lan- 
guage commands, statements and functions listed in alphabetical 
order. We've created a "quick list'' which contains all the words 
and the r abbreviations. This is fo lowed by a section containing a 
more detailed definition of each word along with sumple BASIC 
programs to illustrate how they work, 

• If you need an introduction tu uiinc; machine language with BASIC 
programs our layman's overview will get you started. 

• A powerful feutjre of u I Commodore computers is culled the KER- 
NAl. It heips insure that the programs you write today can else b« 
used on you' Commodore computer of tomorrow. 

• The Input/Output Pragrnmrring section given you the opportunity to 
use your computer to the limit. It describes how to hook-up and use 
everything from lightpens and joysticks tn disk drives, printers, nrd 
telecommunication devices called modems. 

• You can explore the world of SPRITES, program mob le characters, 
and high resolution graphics for the most detailed and advanced 
animated pictures in The microcomputer industry, 

• You can also enter the wo'ld of music synthesis and create your 
own songs and sound effects with the best built-in synthesizer 
available in any personal computer. 

• If you're an experienced programmer, trie soft load language sec- 
tion gives you information about the COMMODORE 64's ability to 
run CP/M* and high level languages. This is in addition to BASIC. 

Think of your COMMODORE 64 PROGRAMMER'S REFERENCE GUIDE 

as o useful tool to help you and you will enjoy *he hours of programming 
ahead of you. 



*CP/*A is e rsgist#r»d trqdermorfc of Digital Research, Inc. 
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HOW TO USE THIS REFERENCE GUIDE 

Throughout this manual certain conventional notations are used to de- 
scribe the syntax (programming sentence structure) of BASIC commands 
or statements and to show both the required and optional parts of each 
BASIC keyword. The rules to use for interpreting statement syntax: are as 
follows; 

1. BASIC keywords are shown in capital letters. They must appear 
whe-e shown in the statement, entered and spelled exactly ae shown. 

2. Items shown within quotation marks (" ") indicate variable data 
which you must put in. Both the quotation marks and the date 
inside the quotes must appear where shown in each statement. 

3. Items inside the square brackets ([ ]) indicate an optional state- 
ment parameter. A parameter is a limitation or additional qualifier 
for your statements. If you use en optional parameter you must 
supply the data for that optional parameter. In addition, ellipses 
( . . . ) show that an optional item con be repented as many times 
as a programming line allows. 

4. If an item in the square brackets ([ ]j is UNDERLINED, that means 
that you MUST use those certain characters in the optional pa- 
rameters, and They also have to be spelled exactly as shown, 

5. Items inside angle brackets (<>) indicate variable data which you 
provide. While the slash ( f ) indicates licit yuu must make a choice 
between two mutjally exclusive options. 

EXAMPLE OF SYNTAX FORMAT: 

0PEr4<file-num>,<d«vice> [.<«ddr&*i>], ["<drive>: <File- 
name>] [,<made>l" 

EXAMPLES OF ACTUAL STATEMENTS: 

10 OPEN 2,8,6,"0:5TOCK FOLIO,S,W" 
20 OPEN 1,l,2,"CHEGKBGOK" 
30 OPEN 3,4 

When you actually apply the syntax conventions in a practical situa- 
tion, the sequence of parameters In Y our statements might not be 
exactly the same as the sequence shown in syntax examples. The 
examples are nol meant to show ever/ possible sequence. They are 
intended to present all required and optional parameters. 
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Programming examples h this bock are shown with blanks separating 
morels and operators for The sake of readability. Normclly though, 
BASIC doesn't require blanks between words u-niess leaving tnem out 
would give you uri ambiguous or incorrect syntax. 

Shown below ore some examples and descriptions of the symbols 
USSrd tor various sluleirienl pururnelera in the hallowing chapters. The ist 
is not meant to show every possibility, but to give you a better under- 
standing as to how syivax examples are presented 



SYMBOL EXAMPLE 

<fite-nur-i> 50 

< device >■ 4 

<addres5> 15 



<drive> 

<flle-name> "TEST. DATA" 

<co nstant> "ABCDEFG" 

<Tvariobler> X145 



<string> 
<number^ 



AB5 
12345 



<line-number> 1000 

<numerie> 1.5E4 



DESCRIPTION 

A logical file number 

A hardware dev'ce number 

A serial bus secondary 

device address 

number 

A physical disk drive number 

The name of a data or program file 

Literal dato suppled by 

Int* programmer 

Any BASIC data variable name or 

constant 

Use of a string type variable required 

Use of a njrneric type variable 

required 

An actucl program lino number 

An integer or floating-pel rr varlabe 



COMMODORE 64 APPLICATIONS GUIDE 

Wnen you first thought about buying cj computer yoj probably asked 
yourself, "Now that I can nfford to buy a com purer, whet ran I do with 
it once I get one?" 

The great thing obout your COMMODORE 64 is *hat you ran make it 
do what YOU want it to do! You can make it calculote and keep track of 
home and business budget needs. You can use 1 for word processing. 
You can moke (t play arcade-style action games. You can make it sing. 
You cut even creofe your uwn animated cartoons, and more. The best 
pert of owning; a COMMODORE 64 is that Oven if it did only one of the 
things listeo below it would be wel worm the price you paid for it. But 
the 64 is a complete computer and it does da EVERYTHING listed and 
then seme! 
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By the way. in addition To everything here you can pick up n lot of 
other creative and practical ideas by signing up with a local Commo- 
dore Users' Club, subscribing to the COMMODORE nnd POWER/PLAY 
magazines, and joining the COMMODORE INFORMATION NETWORK on 
CompuServe™ . 



APPLICATION 



COMMENTS/REQUIREMENTS 



ACTION PACKED 
GAMES 



ADVERTISING & 
MERCHANDISING 



ANIMATION 



BABYSITTING 



BASIC PROGRAMMING 



BUSINESS 
SPREADSHEET 



COMMUNICATION 



Yen enn get rem I Bnlly Midwoy nrende gomes 
like Omega Race, Garf and Wizard of Wor, as 
we!| as "ploy and learn" games like Math 

Teacher I, Home Babysitter end Commodore 
Artist, 

Hook your COMMODORE 64 to a TV, pur it In 
a stare window with a flashing, animated, 
and musical message and you've got a greaf 
point of purchase store display. 

Commodore's Sprite Graphics allow you to 
create reel cartoons with 8 different levels so 
that shapes con move in front of or behind 
eflch other. 

The COMMODORE 64 HOME BABYSITTER 
Cartridge can ketep /our youngest child occu- 
pied for hours and teach alphabet/ keyboard 
recognition at the same time. It also teaches 
special learning concepts and relationships. 

Your COMMODORE 64 USER'S GUIDE and the 
TEACH YOURSELF PROGRAMMING series of 
books and tap*s offer an excellent starting 
point. 

The COMMODORE 64 offers rhe "Easy" series 
of business aids including the most powerful 
word processor and largest spreadsheet 

cvailable for any personul compute! , 

Enter the fascinating world of computer "net- 
working," If you hnnk a V1CMODEM to yaur 
COMMODORE 64 you can communicate with 
other computer owners all around the world. 
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COMPOSING SONGS 



CP/M" 



DEXTERITY TRAINING 



EDUCATION 



FOREIGN LANGUAGE 



GRAPHICS AND ART 



Not only thot, if you [oin the COMMODORE 
INFORMATION NETWORK on CompuServe™ 
you can cjet the latest news and updates on 
□II Commodore products, financial informa- 
tion, shop ot home services, you can even 
play games with the friends you make through 
the information systems you [oin. 

This COMMODORE 64 is equipped with trie 
nioii ssj(jliisiicuifed byil--in music synthesizer 
available on any computer. It has three com- 
pletely programmable voices, nine -ull music 
nrraves, and four eontrollabe waveforms. 
Look for Commodore Music Cartridges and 
Commodore Music books to help you create or 
reproduce all kinds of music and sound effects. 

Commodore offers a CP/M* add-on and ac- 
cess to software through an easy-to-load car- 
tridge. 

Hand/Eye coordination and manual dexterity 
ore aided by several Commodore games . . . 
including "Jupiter Lander" and night driving 
simulation. 

While working with a computer is an educa- 
tion in itself. The COMMODORE: fcducational 
Resource Book contains general information 
on the educational uses of computers. We 
also have a variety of learning cartridges de- 
signed to reach everything from music to math 
and art to astronomy. 

The COMMODORE 64 programmable char- 
acter set lets you replace the standard char- 
acter set with tiier defined foreign language 
characters. 

In addition to the Sprite Graphics mentioned 
above, the COMMODORE 64 offers high- 
resolution, mufti-color graphics plotting, pro- 



"CP/jW is a Registered tiaeemcrk of Digital Research, inc. 
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INSTRUMENT 
CQH7R0L 



JOURNALS AND 
CREATIVE WRITING 



LIGHTPEN CONTROL 



MACHINE CODE 
PROGRAMMING 



PAYROLL & FORMS 
PRINTOUT 



PRINTING 



RECIPES 



grammable character, and combinations of 
aJI the different graphics urid churuder dis- 
play mcdes. 

YoLf COMMODORE 64 has a se-icl part, 
fiS-232 port anal a user pott for use with a 
variety of special industrial applications. An 
IEEE/488 cartridge is also availcble as an op- 
tionul extra. 

The COMMODORE 64 will soon offer an ex- 
ceptional wordprocessing system that matches 
or exceeds the qualities and f edibilities of 
most "high-priced" wordprocessors available. 
Of course you con save the information on 
either a 1541 Disk Drive or a Dulcssetle™ 
recorder ond have it printed out using a VIC- 
PRINTER or PLOTTER. 

Applications requiring the use of a lightpen 
tan be performed by any lightpen that will fit 
the COMMODORE 64 gome port connector, 

Your COMMODORE 64 PROGRAMMER'S REP 
ERENCE GUIDE includes a machine language 
section, as well as a BASIC to machine cade 
interface section. There's even a bibliography 
ovai able for more in-deptK study. 

The COMMODORE 64 can be programmed to 
handle a variety of entry-type business appli- 
cations. Upper/lower case letters combined 
with C64 "business form" graphics make it 
easy for you to design forms which can -then 
be printed on your pointer. 

The COMMODORE 64 inte-face* with a vari- 
ety of dot matrix and letter quality printers as 
well as, plotters. 

You can store your favorile recipes on yojr 
COMMODORE 64 and its disk or cassette 
storage unit, arid end the need for messy rec- 
ipe cards that often get lost when you need 
them most. 
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SIMULATIONS Computer simulations let you eondjct danger 

ous or expensive experiments at minimum risk 

and cost. 

SPORTS DATA The Source™ and CompuServe™ bcti offer 

Sports information which you can get using 
your COMMODORE 64 and a VICA\ODEftA. 

STOCK QUOTES With a VtCMODEM und u subscription to any 

of the appropriate network services, your 
COMMODORE 64 became:* your own fjrivute 
stock ticker. 

These are just o few of the many app ications for you and your 
COMMODORE 64. As you can See, for work or play, at home, in school 
or the office, your COMMODORE 64 gives you a practical solution for 
ju5t abuul uny need. 

Commodore wants you to know that our support lor users only STARTS 
with yojr purchase of a Commodore computer. That's why we've 
treated two publications with Commodore information from around the 
world, and a "two-way" computer information network with valuable 
input for Lsers in the U.S. and Canada from coas- to coast. 

In addition, we wholeheartedly encourage and support the growth of 
Commodore Users' Clubs around the world. They are an excellent source 
of information 'or every Commodore computer owner from the beginner 
to the most advanced, The magazines and network, which are more 
fully described below, have the most up-to-date information about how 
to get involved with the Users' Club in /ou r area. 

Finally, your local Commodore dealer is a useful source of Commo- 
dore suppo't and information. 

POWER/PLAY 

The Home Computer Magazine 

When it comes ta entertainment, learning at home and practical home 
applications, POWER/PLAY is THE prime source Df information fo- Com- 
modore home users. Kind ojt where your nearest user clubs a'e and 
what they're doing, learn abojt software, games, orogramrning tech- 
niques, telecommunications, and new products. POWER/PLAY is your 
personal connection to other Commodore users, outside software and 
hardware developers, and to Commodore itself. Published quarterly. 
Only $10,00 for a year of home computing excitement. 
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COMMODORE 

The Microcomputer Magazine 

Widely read by educators, businessmen and students, aa well as 
home cornputerists, COMMODORE Magazine r s our morn vehicle for 
sharing exclusive information on the more technical use of Commodore 
systems. Regular deportments cover business, science and education, 
programming tips, "excerpts From a technical notebook," and many 
other features of interest to orycre who uses or is thinking about pur- 
chasing Commodore equipment for business, scientific or educational 
applications. COMMODORE is this ideal cam pie merit to POWER/ PLAY. 
Published bi-monthly. Subscription price: $15.00 pet ysctr. 

AND FOR EVEN MORE INFORMATION . . . 

. . . DIAL UP OUR PAPERLESS USER MAGAZINE 

COMMODORE INFORMATION NETWORK 

The magazine of the future is here. To supplement and enhance your 
subscription to POWER/PLAY and COMMODORE magazines, the COM- 
MODORE INFORMATION NETWORK— our "paperless magazine" is 
uvui table now over the telephone using your Commode re computer and 
modem. 

Join our computer club, get heip with a computing problem, "talk" to 
other Commodore friends, or get i.p-to-the-minute info'tnction on new 
products, scHware and educational resources. Soon you will even be 
abfe to save yourself the trouble rjf Typing in the program lrs?hgs you 
find in POWER/PLAY or COMMODORE by downloading direct from the 
Information Network (a rew jser service planned for early 1983). The 
bes' part is that most of the answers are there before you even ask the 
questions. (How's that fo r service?) 

To call cur electronic magazine you need only a modem and a sub- 
scription to CompuServe™, one of the nation's largest telecommunica- 
tions networks. (To make it easy for you Commodore includes a = REE 
year's subscription to CompuServe™ in each VICMODEAA package,) 

Just dial your local number tor the CompuServe™ data bark and 
connect your phone 1a the modem. When the CompuServe™ video text 
appears on ycur screen type Q C3M en your computer keyboard. When 
the COMMODORE INFORMATION NETWORK'S table of contents, sr 
"menu," aopears on your screen cheese from one of our sixteen de- 
partments, make yourself comfortable, and enjoy The paperless maga- 
zine other magazines are writing about. 
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For mere information, visit your Commodore dealer or contact Com- 
puServe™ customer service at 800-848-8990 (in Ohio, »1 4-457-8600;. 
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BASIC 

PROGRAMMING 

RULES 

■ Introduction 

' Screen Display Codes (BASIC 

Character Set) 
' Programming Numbers and 

Variables 
1 Expressions and Operators 
• Programming Techniques 



INTRODUCTION 

This chapter talks about how EASIC strires aid manipulates data. The 
topics include: 

1) A br ef rrenrion nf the operating system components and funct : ons 
as well as the character set used in the Commodore 64. 

2) The formafinn of constants and variables. What types of variables 
there are, And how constants and variables are stored in memory. 

3) The rules for arithmetic calculations, relationship tests, strina hcn- 
dling, and logical operations. Also included are the rules for form- 
ing expressions, and the data conversions necessary when you're 
j sing BASIC with mixed data types. 

SCREEN DISPLAY CODES 
(BASIC CHARACTER SET) 

THE OPERATING SYSTEM (OS) 

The Operot'ng System is ccntained in the Read Only Memory (ROM) 
chips and is a combination of three separate, but rterrelatcd, program 
modules. 

1) The BASIC Interpreter 

2) The KF(?WAL 

31 The Screen Editor 

I ) The BASIC Interpreter is responsible tor analyzing BASIC state- 
ment syntax and for performing the required calculations und/or 
data manipulation. The BASIC Interpreter has a vocabulary of 65 
"keywords" which have special meanings. The upper and iower 
case nlphabet end 1he digits 0-V are used to make both keywords 
and variable names. Certain punctuation characters arid special 
symbols also have mannings far the interpreter. Table l-l lists the 
special characters and their uses. 

2) The KERNAL handles most of the interrupt level processing in the 
system (for detcils on interrupt level processing, see Chapter 5). 
The KERIMAL cUo does the actual input and output of oata. 

3) The Screen Editor centrals the output 1o the videc screen {television 
set) and the editing of BASIC program text. In addition, the Screen 
Editor intercepts keyboard input so *rial it can decide whether the 

1 BA5IC PROGRAMMING RULES 



Table 1-1. CB.M BASIC Character Set 



CHARACTER 



NAME and DESCRIPTION 



$ 



< 



TT 



BLANK separates keywords and variable names 
SFMI-CQLQN — used in variable lists to format output 
EQUAL SIGN — value assignment and relationsiip 

Tesring 
PLUS SIGN — arithmetic addition or string concatenation 
{concatenation: linkrg Togetherin □ chain) 
MINUS SIGN arthmetlc subtraction, unary minjj( — 1 ) 
ASTERISK- — arithmetic multiplication 
SLASH — arithmetic division 
UP ARROW — arhhmeri^ exponentiation 
LEFT PARENTHESIS — expression evaluation and 

functions 
RIGHT PAREN'HESIS — expression evaluation and 

functions 
PERCENT — declares varable nam© as an integer 
NUMBER — comes before locjica file number in input/ 

output statements 
DOLLAR SIGN — declares variable name as a siring 
COMMA — used in vctririhjlA lists to formct oufput; 

also separates command parameters 
PERIOD^ — decimal point in floating point constants 
QUOTATION MARK — encloses string constants 
COLON — separates multiple BASIC statement in a line 
GUESf ION MARK — cbbreviatlon fcr the keyword PRINT 
l_tSS THAN — used in re ntinnship tests 
GREATER THAN — used in relationship tests 
P! — the numeric constant 3.141592654 



characters put in should be acted uprvn immpdinlely 
to the BASIC Interpreter, 

The Operating System gives you two modes cf BASIL 

1) DIRECT Mode 

2) PROGRAM Mode 



or passed on 
operation: 



1) When you're using 1he DIRECT mode, BASIC statements don't have 
line nurrbers in frurit of the statement. They are executed 
whenever the | key Is pressed. 

2) The PROGRAM mode is the one you use for running programs, 
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When using the PR0GRAA1 mode, all of your BASIC statements 
must hove line numbers in front of them. You can have mere than 
one BASIC statement in a line of your program, but the number of 
statements is limited hy ihe fact that you can only put 80 char- 
acters or a logical screen lire. Th s means that if you are going to 
go over the SO character limit you have to put the entire- BASIC 
statement thot doesn't fit on a new lire with u new line numbe", 



NOTE: Alj*ayt type NEW and hit Q Q before starli iy u new program. 



Tin* Commodore 64 has two complete character sets that you can use 
either from trie keyboard or in your programs. 

In SET 1 , the upper case alphabet ard the numbers 0—9 are available 
without pressing the £|jy| key. It you hold down the tlillil key 
while typing, the graphics characters yu the RIGHT side of the front of 
the keys ore- used. If yoj hold down the Q key whi e tyoing, the 
graphics characters on the LEFT side of the front of the key are used. 
Holding down the ^El k*Y wnile typing cny character that doesn't 
have- graphic symbols on the front of the key gives you the symbol on the 
top mosr part oF the key. 

In SET 1. the lower case alphabet and the numbers 0-9 are available 
without pressing the ESEI key. Tne upper rase alphabet is available 
when you hold down -he EH3 key while typing. Again, the grapl it 
symbols on the LEFT side of the front of the keys ore displayed by press- 
ing the Q key, while the symbols on the top most part of any key 
wilhout graphics characters are selected when you hold down 
the Ijjiyf key while typing. 

To switch from one character set tD the other press the and 
the EB ke >'5 together. 

PROGRAMMING NUMBERS AND VARIABLES 

INTEGER, FLOATING-POINT AND STRING CONSTANTS 

Constants are the data va ues that you put in your BASIC statements. 
BASIC uses these valuers lu represent data during statement execution. 
CBM BASIC can recognize and manipulctc- throe types of constants: 

I j INTEGER NUMBERS 

2) FLOATING-POINT NUMBERS 

3; STRINGS 
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Integer constants are whole numbers (numbers without decimal 
points). Integer constants must be between —32768 and +32767. in- 
teger ronsfanTs do not have decimal points or commas between digils. 
If the plus ( + 1 sign is loft out, the constant is assumed to be a positive 
number. Zeros coming before a constant are Ignored one shouldn't be 
used since they waste memory end slow down your program. However, 
They won't cause an error. Integers are storec in memory as two-byte 
binary numbers. Some examples o f integer constants ore: 

-12 

8765 
-32/68 

+ 44 



32767 



NOTE; 


Do NUT put commas 


in 


ide 








always type 32,000 cs 


any njnnber. 


For example 


32000 


It you put a con mQ 


In 


thft 


middle &f a 


numbe' 


you will ge- 


(he BASIC error 


mMSO 


no 75YMFAX ERROR. 

















Floating-point constants are positive or negative numbers and cars 
contain fractions. Fractional ports of a number mny be? shown using a 
decimal point. Once again remember that commas are NOT used be 
tween numbers. If the plus sign ( + ) Is left off rhe front of a numoer. The 
Commodore 64 assumes thai the number is positive. If you leave off the 
decimal point the computer will assume that it fallow? the Inst digit of 
the number. And as with integers, zeros that come before a constant 
ore ignored. Flnnting-pnlnr consranrs can be used In two ways; 

1) SIMPLE NUMBER 

2) SCIENTIFIC NOTATION 

Floating-point constants will show you up to nine ciglts on your screen. 
TiRse digiTs car represent values between -999999*99. and 
+ 999999999. If you enter more than nine digits the number will be 
rounded based an the tenth digit. If the tenth digit s greater than or 
equal to 5 the number wi'l be rounded upward. Less then 5 the numoer 
wilt be rounded downward. This could be important to the f nal totals of 
some numbers you may want to wa'k w'th. 

Floating-point numbers are stored [using five bytes of memory) and 
are manipu'ated in calculations w'th ter places of accuracy. However, 

EASIC PROGRAMMING RULES 5 



the numbers are rounded to nine digits when results are printed. Some 
examples of simple floating-point numbers are; 

1.23 

.99BB77 
+ 3.T459 
.7777777 
-333. 
.01 

Numbers smaller than .01 or larger *han 999999999. will be printed in 
scientific nolation. in suenlifk r ulufkjn u floating-point constcnt is made 
up of three parti: 

1) THE MANTISSA 

2) THE LETTER E 

3) THE EXPONENT 

The mantissa is a simple floating-point number. The letter E is- used to 
te I you that you're seeing the number in exponential form. In other 
words E represents *I0 (eg., 3E3=5* 10t3 = 30G0j, Arid Hie exponent is 
what multiplication power of 10 the number is rcised to. 

Both rhe mantissa and the exponent ere signed (4- or ) numbers. 
The exponent's range is from —39 to +38 and it indicate? the number of 
places that the actual decimal point in the Tiantfsso would be moved to 
the lefl (— ) or right (+i if the value of rhe constant were represented as 
a simple number. 

There is y imit to the size of floati n g-pofnt numbers that 3ASIC can 
handle, even In scientific notalion: the largest number is 
+ 1 ,701 41 183E+3S end toktlylioris which would r esijrf ir a Icrger 
number will display the BASIC error message 70VERFLOW ERROR. The 
smallest flocting-point number is + 2.92873588E-39 and calculations 
which result n a smal er value give you zero as an answer and NO e'rer 
message, Some examples of floor tfng- point numbers in scientific notation 
(and their decimal value*) are: 

235.988E-3 [, 235968) 

235PE6 12359000000.) 

-7.09E-12 ! -.00000000000709) 

-3.T4159E+5 (-314159.) 

String constants tire groups of alphanumeric information like letters, 

numbers and symbols. When you enter a string from the keyboard, t 
can have any length up ro the space available in an 80-character line 
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(thct '&, any character spaces NOT taken up by The line number and 
other required parts of the statement), 

A string constant can conTa.fr> blanks, etters, numbers, punctuation 
and color or cursor control characters in any combination. You can even 
put commas between numbers. The only character v/hich cannot be in- 
dvded in a sf'fng is the doubic quote mark ("). This is because the 
double quote mark is used to define the beginning ard end of tns string. 
A string can also have a null value — which means thot it ccn contain no 
character data. You con leave the ending quote mark off of a string if 
it's the last item on a line or if it's followed by a colon (:). Some exam- 
ples of string constants are: 

"" ( a null string) 

"HELLO" 

"$25,000.00" 

"NUMBER OF EMPLOYEES" 



HOIE: Use CHR$.;34) to includ* quotM (") in string!. 



INTEGER, FLOATING-POINT AND STRING VARIABLES 

Vbr/ubfes are names Hiiit represent dulu values used in your BASIC 
statements. The va:ue represented by a variable can be assigned by 
setting it equal to a constant, or it can be the result of calculations in llie 
program. variable data, like constants, can oe integers, tloating-poirt 
numbers, or strings. If you refer to a variable name in a program before 
n ualue has been assigned, the BASIC Interpreter will automatically 
create the variable with a value of zero if it's an integer or floating-point 
number. Or it will create a variable with a null value if you're using 
strings. 

Variable names can be any length but only the first two characters 
are considered significant in CBM BASIC. This means that all names 
used for variables mL5t NOT have the same first two characters. Vari- 
able names may NOT be the same as BASIC keywords and they may 
NOT contain keywords in the middle of varicble names. Keywords in- 
clude all BASIC commands, statements, function names and logical 
aoerator names, If you accidentci ly use a keyword in the middle of a 
variable name, the BASIC error message 7SYNTAX ERROR will show up 
on your screen. 

The characters used to form variable names are the alphabet and the 
numbers 0—9. The firsl character uf the name must be a letter. Data 
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type declaration characters [%) and (S) ran be used as the last char- 
acter of the name. The percent s gn (%) declares the variable to be an 
integer and the dollar sign ($) dec ares a string ^arable. If no type 
declaration character is used the Interpreter wiU assume that the vari- 
able is a floating -point. Some examples o f variable names, value as- 
signments and data types are: 

A$ = "GR05S SALES" (string variable) 
MTH$ = "JAN"+A$ (string variable) 



t% = 5 

CNT%=CNT% I 1 

C P=12.5 

SIM = FP*CNT% 



integer variable) 
integer variable) 
floating-point variable) 
'flocitincj-puiril vu-iuble) 



INTEGER, FLOATING POINT AND STRING ARRAYS 

An array is a taole (or list] of associated data items referred lo by u 
single variable narnft. In other ward*, nn r.rmy is o sequence of related 
variables. A table of numbers can be seen as an array, for example. 
The individual numbers within the table become "elements" of the 

arrCy. 

Arrays tire n useful shorthand way of describing o large nrnnher pf 
related variables- Take a table of numbers for instance. Let's say that 
the taole has 10 raiws of nutibers wirh 20 numbers in each row. That 
makes a total of 200 numbers in the table. Without a single array natic 
to call on you would have ro assign a unique name to each value In the 
table. But because you can use arrays you only need one name for -he 
array and ull f he elements in the array are idennfied ay their individual 
locations within the array. 

Array names can be inleyers, Houlmy-puinlSi or striny dulu types and 
all elements in the array have the same data type as the array name, 
Arrays can have u single dimension (as in a simple list) or they can have 
multiple dimensions (imagine a grid marked in rows and columns or a 
Ruby's Cube ). Each element of an array is uniquely identified and re- 
ferred to by c subscript lor index variable) following the array name. 
enclosed within parentheses ( ). 

The maximum number cf dimensions en array can hove in theory is 
255 arid the number of elements in each cimension is limMed to 32767 
But far practical purposes array sizes ere limited by the memo'y spece 
available to hold their data and/er the EC character <ogical screen line, 
If an orray has only one dimension and its subscript vnlne will never 
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exceed 10 (11 items: thru 10) then the array will be created by the 
Interprete' and fil ed with zeros (or nulls it string type) the first time any 
elernenl of tiie arruy is referred to, othewise ihe BASIC DIM statement 
must be used to define the shape and size of the arrey. The amount of 
memory required fo Store on array tor be determined ai follows: 

5 bytes tor the orray name 
+ 2 bytes lor each d'mension of the array 
4- 2 bytes per element for integers 
OR +■ 5 bytes per element for flcctl rig-point 
OR +- 3 bytes per elerrent -or strings 
AND +■ l byte pe" chiurueter in euth slriny element 

Subscripts car be integer constants, variables, or or arithmetic ex- 
pression which gives nn integer restih. Separate subscripts, with com- 
mas bstween th**m, are required for eoch dimension of an array. Sub- 
set - pts can haw* values *rom rero up to the number of elements in the 
respective dimensions of the array. Values outside that range will cause 
the BASIC error message ?BAD SUBSCRIPT. Some examples of array 
names, value assignments and data types are: 

A$(0)="GROSS SALES" (string array) 

MTH$(K%)="JArJ" (string array) 

G?%(X)=5 (integer array) 

CNT%(G2%{X);-CNT%il)-2 (integer arroy) 

FP(12*K%)=24.8 (floating-point array) 

&UM(CNT%(l»==FPfK% (floating-point array] 

A(5) = (sets the 5th element in the 1 dimensional 

a fray called 'A" equal to D) 

B!5,a) = Q (sets the element in row position h and 

column position 6 in the 2 dimensional array 
called ' B" equal to 0) 

C(l ,2,3) = (sets the element in raw position 1, column 
position 2, and depth position 3 in the 

S dimerisiunai array tailed "C" equol to 0) 



EXPRESSIONS AND OPERATORS 

Expressions are formed usinc constants, variables and/or arroys. An 
expression curi be o single cunstcnr, simple variable, or an array vari- 
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ab e of any type. II can also be a combination of corsfcinrs and vari- 
ables with arithmetic, relational or logical operators designed to 
produce a jingle value. How operators work h explained below. Ex- 
pressions car be separated into two classes: 

1) ARITHMETIC 

2) STKING 

Expressions are normally thought of as having two or more data items 

caled operand?. Each operand is separated by a s'nglc operator to 
produce the desired resut, This h usually done by assigning "he value of 
the expression to a variable nane. All of the ©samples of constants and 
variubes that you've seen so lur, were also examples of expressions. 
An operator is a special symbol the BASIC Interpreter in /our Com- 
modore 64 recuyriizei us representing an opercilian Ip be performed on 
tne variables or constant data. One or more operators, combined with 
one or mare variables and/or constants form an expression. Arithmetic, 
relational and logical cperators are recngni7ed by Commodore 64 
BASIC. 

ARITHMETIC EXPRESSIONS 

Arithmetic expressions, when solved, wffl give an integer or floating- 
point value, The arithmetic operators ( — , — , *, /, f) ore used to perform 
cddition, subtraction, multiplication, division and exponentiation opera- 
tions respectively. 

ARITHMETIC OPERATIONS 

An arithmetic operator defines an arithmetic operation which is per- 
formed an the two operands on ei'her side cf the cperotor. Arithmetic 
operations are performed using floating-point numbers. Integers are 
converged to floating-point numbers before an arithmetic operation is 
performed. ~he result is converted back to an integer if it is assigned to 
an integer variable name. 

ADDITION ( + ): The plus sign (+) specifies tnat the operana on the 
right is added to the operand on the eft. 
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EXAMPLES: 

2 + 2 

A+B+C 
X%-1 
BR II OE 2 

SUBTRACTION (— ); The minus iign [—) specifies "that the operand on 
the right 1 is subtracted from the operand nn the left. 

EXAMPLES: 

4-1 

100-64 

A-B 

55-142 

The minjs can also be used as a unarv minus. That means that it is 
the minus sigr, in front of a negative number, this is equal to subtracting 
the number from iero (D). 

EXAMPLES: 

-5 

-9E4 

-B 

4- (—2] same as 4 + 2 

MULTIPLICATION (*): An asterisk (*> specifies that the op&rand on the 
left Is multiplied by the operand on the right. 

EXAMPLES: 

100*2 
50*0 
A*X1 
R% + 14 

DIVISION (/): The slash (/) specifies that the operand an the left is 
divided by the operand on the righ1. 

EXAMPLES; 

10/2 

4^00/4 

A/E 

4E2/XR 
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EXPONENTIATION (f): The up arrow if) specifies that the operand on 
the left is raised to the power specified by the operand on the right (the 
exponent). If the operand on the right is a 2, the rumber on the left is 
squared; if the exponent is a 3, the numhe r on -he left is cubed, etc. The 
exponent con be any n j-nber 50 long as the result of the operation gives 
a valid floating-point number. 



EXAMPLES: 










2t2 


Equivalent to; 


2*2 




3|3 


Equivalent to; 


3*3*3 




4T4 


Equivalent to; 


4^'4M 




ABfCD 








3f-2 


Equivalent to: 


V3*l/3 



RELATIONAL OPERATORS 

The relational operators (<, =, >, <— , > = , <^=) are primarily used 
to compare the values of two operands, but they also produce an a-irh- 
metic result, The relational operators and the logical operators (AND, 
OR, and NOT}, when used in comparisons, actually produce an a'ith- 
metic *rue/false evaluation of an expression. If *he re ationship stcted in 
the expression is true the nssull is ussiyned an irvleyer value uf — 1 und if 
it's false a value of is assigned. These are the relational operators: 

< LESS THAN 
EQUAL TO 
> GREATER THAN 
<= LESS THAN OR EQUAL TO 
>- GREATER THAN OR EQUAL TO 
<> NOT EQUAL TO 



EXAMPLES: 

1 -5-4 result try* (-1) 

14>66 result false (0) 

15> = 15 result true (- I) 

Relatione; operators can be used to compare strings. For comparison 
purposes, the letters of the alphabet have the orde- A<B<C<D, ete. 
Strings are compared by evaluating the relationship between corre- 
sponding characters from left to right (see String Operations), 
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EXAMPLES: 

"A" < "B" res j!t True ( - 1 ) 

"X" - "YY" result false [0) 
BB$ <> CCS 

Numeric data items can only be compared {or assigned; to other 
numeric items. The suine is Irue when comparing strings, otherwise the 
BASIC 9'rcr message ?TYPE MISMATCH will occur. Numeric operandi 
are compared by first converting the va'ues of either or both operands 
■from integer to floating-point Form, as necessary Then the relations-iip 
of the floating-point values Is evaluated to give a true/false result. 

At the end of rill compnrisnns, you get an integer no matter what 
data type the operand 13 (even If both are strings). Because of this, a 
comparison of two operands con be used ns an operand in oerfarm r.g 
calculations. The result wi : l be 1 or and can be used as anything but 
n divisor, since division by zero is illegal. 

LOGICAL OPERATORS 

The logical operators <AND, OR, NOT) can be used to modify the 
meanings of the relational operators or to produce an arithmetic result. 
Logical operators ccn produce results other than — 1 end 0, though any 
nonzero result is considered true when tsslirty for a h ue/false condition, 

The logical operator? (sometimes called Boolean operator;} can also 
be used to perform logic operation* or indvidjal binary digits (bits) in 
two operands. But when you're using the NOT operator the operation is 
performed only on the single operand to the right. The operands must 
be in the integer range of values ( — 3?7f>R tn +327A7) (flnoting-point 
numbers are converted to integers) and logical operations give ar in- 
teger result. 

Logical operations are performed bit by corresponding bit on the two 
ope-ands. The ogical AND produces a bir rescb of 1 only if both 
operand bits ore 1, The logical OS produces a bit result of 1 it either 
operand bit is 1. The logical NOT is I he opposite value of each bit as a 
single operand. In other words, it's really saying, "If it's NOT ! then it is 
0. If it's NOT then it is 1." 

The exclusive OP (XOR) doesn't have a logical operator but it is Der- 
fcmied as pa i of the WAIT statement. Exclusive OR means that if the bits of 
two operands are equal then the result is p otherwise the result is 1 . 

Logical operations ore defined by groups o ; statements which, taken 
together, constitute a Boolean "truth table" as shown in Table 1-2. 
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Table 


1 


-2. Boolean 


Truth Table 




The 


AND 


ope rat 


on resu 


ts 


in a 1 or 

1 AND 1 
AND 1 


ly 


if both 

1 



bit? 


are T: 

1 



1 AND = 

AND = 

The OR operation results in a 1 if either bit is 1: 

1 OR 1 = 1 
OR 1 = I 













1 UK u 


1 
















OR 


= 






The 


NOT 


ope 


ration 


log 


cally compl 

NOT 1 = 
NOT = 


smertts 

= 
= 1 


each 


bit; 


The 


exclui 


ive 


OR (XOR) 


is [jart of t! 


e WAIT statement: 












1 XOR 1 


= 
















1 XOR 


= 1 
















C XOR 1 


= 1 
















XOR 


= 







The- logical operators AND, OR and MOT specify a Boolean arithmetic 
operation tu be performed on the two operand expressions on eilher 
side of the operator. In the case of NOT p ONLY the cp^rand or the 
RIGHT t$ considered. Logical operations (or Boolecn arithmetic) aren't 
performed until all arithmetic end relational operations in an sxpressiori 
have been completed. 



EXAMPLES: 

IF A=10O AND B=100 THEN 10 

A=96 AND 32: PRINT A 
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(if both A end B have a value 
of 1 DO -hen the result h 
true) 

{A - 32) 



IF A= 100 OR B=100 THEN 20 (H A or B is 100 Trien The 

result is true) 

A=£4 OR 32; PRINT A (A = 96) 

IF NOT X<Y THEN 30 (if X>=V the rssult is true) 

X= NOT 96 (result is — 97 (two's complement)) 



HIERARCHY OF OPERATIONS 

Ail expressions perfcm the different types of uperaliuns according to 
a fixed hierarchy. In other weds, certain operations are performed be- 
fore other operations. The normal order of operations cur. Le modified 
by enclosing two or more operands within parentheses ( ), creating a 
"subexpression," The parts of an expression enclosed in parentheses will 
be reduced to a single va ue before working on part* outside the- par- 
entheses. 

When you jsc parentheses in expressions; they must be paired so that 
you alwoys have on equal number of left and right parentheses. 
Otherwise, the BASIC error message 7SYNTAX ERROR will appear. 

Expressions which have operands inside parentheses -nay tiemselvss 
be enclosed in parentheses, forming complex expressions of multiple 
levels. This is called nesting,. Parentheses can be nested in expressions 
tq a maximum depth of ten levels — ten matching sets of parentheses. 
The inner-most expression has its operations performed first. Some 
examples of expressions ore: 

A+B 

Cf [D 1 E)/2 

((X-Cf(D+ EJ/2)* 1 0)+ 1 

GC$>HH$ 

JJ$-K'MORE JJ 

K%-1 AND MOX 

K%=2 OR (A=B AND M<X) 

NOT (D-E) 

The BASIC Interpreter will normally perform operations on expressions 
by performing arithmetic operations first, then refationaf operations, an d 
logical operations last. Both arithmetic and logical operators have an 

BaSIZ PROGRAMMING RULES 15 



order of precedence (or hierarchy of operations) within themselves. On 
the other hand, relational operators do not have an order of precedence 
and will be performed a? the expression, is evaluated from left to right. 
If all remaining operators in an expression have the same level of 
precedence then operations happen from left to right. When performing 
operations on expressions within parenlheses, the normal order of pre- 
cedence is mairrained. The hierarchy of arithmetic and logical opera- 
tions is shown in Table 1-3 from first to last in order ot precederce. 



Table 1-3. H 


ierarchy of Operations Performed 


on Expressions 


OPERATOR 


DESCRIPTION 


EXAMPLE 


T 


Exponentiation 


BASE "[EXP 


- 


Negation (Unary Minus) 


-A 


V 


Multiplication 


AB » CD 




Division 


EF / GH 


+ - 


Addition 


CNT +- 2 




Sub-ract or 


JK - PQ 


> = < 


Relational Operations 


A <= B 


NOT 


Logical NOT 

(Integer Two's Complement) 


NOT K% 


AND 


Logical AND 


JK AND 128 


OR 


Logical OR 


PQ OR '5 



STRING OPERATIONS 

Strings ore compared using the same relational operators ( = , <>, 
< = , > = , <, >) that are used for comparing numbers. S-ring compari- 
sons rjr& mods by raking one character at a lime (lefr-to-right) from 
each string and evaluating each character code position frorr the PEL 1 
CBM character set. If the character codes ere the same, the characters 
are equal. If the chcracte* codes differ, the character w ; th -he ln*ver 
rode number is lower in the character set. The comparison stops when 
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the end of either string is reached. AH other things being equal, the 
shorter string is considered less ihun the longer string. Leading or trail- 
ing blanks ARE significant. 

Regardless of the data types, at the end of all comparisons you get 
an integer result, This is true &*/&n if both operands are strings. Because 
of this a comparison of two string operands con be used as an operand 
in performing calculations. The result will be — 1 or (fue or false) ond 
con be used us anything bu1 a divisor since division by zero is illegal, 

STRING EXPRESSIONS 

Expressions are treated as if an implied "<>0" follows them. This 
means that if an expression h true then the next BASIC starements on- 
the sarre program line ere executed. If the expression is fulse lie resl u : 
the line is ignored and the next line in the program is executed. 

Just as with numbers, you can ulsu perform opei alions on string vari- 
ab es. "he only &tr rg arithmetic operator recogijed by CRM RASIf. is 
the plus sign (+) whith is used 1o perform concatenation of strings. 
When strings ore concatenated, the string on the right of the plus sign is 
appended to the string on the left, forming a third string es a result, The 
result can be printed immediately, used :n a comparison, or assigned to 
a variable name- If a string date item is compared with (or set equal to) 
a numeric item, or viee-varsa, rhe BASIC erro' message ?TYPE MIS- 
MATCH will occur. Some examples of string expressions and concatena- 
tion are: 

10 A$ = "HLE" i B$ = "NAME" 

20 NAM$ = AS I B$ (give* ths string; FILENAME) 

30 RES$ = "NEW " + At + B$ (gives tha string: NEW FILENAME) 

t 



Note space here. 
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PROGRAMMING TECHNIQUES 

DATA CONVERSIONS 

When necessary, the CBM BASIC Interpreter will convert a numeric 
dam ilern from an integer to floating-point, or vice-versa, according \a 
the following rules; 

• All arithmetic end relational operations arc performed in floating- 
point format. Integers ore converted to floating-point form for 
evo uation of tie expression, ond *he result is converted back to 
integer. Layicu 1 operations convert their operands to integers and 
return an integer result. 

• If a numeric variable name of one type is set equal (o a numeric 
data Item of a different type, the number will be converted and 
stored as the data type declared in the variable nant. 

• When a floating-point value is converted to on integer, the frac- 
tional portion is truncated (eliminated) and the integer result is less 
than or equnl to trip ^nntinn -point value If the result Is nnrsirle the 
range of +32767 thru -3276S, the EASIC error -nessage ^ILLEGAL 
QUANTITY will occur. 



USING THE INPUT STATEMENT 

Now that you know what variables are, lefs take that Information and 
put it together with the INPUT statement tor some practical program- 
ming applications. 

In our first example, yuu tan think of a variable as a "storage com- 
partment" where the Commodore 64 stcre-s the Liar's response to your 
prompt question. To write a program which asks the user to type in a 
name, you might assign the vnrioble N$ to the name typed in. Now 
every time you PRINT Nf n your program, the Commodore 64 will 
outc maritally PRINT -he name that the user typed in. 

Type the word NEW on your Commodore 64. Hit the B ' ^ey, 

and try this example: 

10 PRINT "YOUR NAMEMNPUT N$ 
20 PRINT "HELIO," N$ 
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In rhis example you used N to remind yourself that this variable stands 
for "NAME." The dollar sign (Si is used to tell the computer that you're 
u&ing a string variable. It is important to differentiate between the two 
types of variables: 

1) NUMERIC 

2) STRING 

You p'obably remember from the earlier sectbns that numeric vari- 
ables are used to siote number values such as I, 100, 4000, etc. A 
numeric variable can bs a single letter (A), any two letters (AB), a letter 
and a number (Al), or two letters and c mmber (AB1). You can save 
memory space by using shorter variables. Another helpful hint Is to use 
letters and numbers for different categories in the same program (Al , 
A2 r A3). Also, if you want whole numbers for nn nniw^r instead nf 
numbers uvith decimal points, all you have lo da Is put a percent sign 
(%} at the end of your vnrinbb name (AB%, Al%, etc.) 

Now let's look at a few examples thot use different types of variables 
and expressions with the INPUT statement. 

10 PRINT "ENTER A NUMBER'MNPUT A 
20 PRINT A 

10 PRINT "ENTER A WORD'MNPUT A$ 
20 PRINT A$ 

10 PRINT "ENTER A NUMBER J ' ; INPUT A 
20 PRINT A "TIMES 5 EQUALS" A*5 



won 


F*nmple 


'A fihnwi 


Hi 


nt MESSAGES 


at 


PROA1PT5 


are 


Ins 


de -he 


quotation 


mark* (" 


") while th 


i '/ariab 


m% 


ore ouHide. Mali 


39, tor, tho 


i in 


ins 


70 the vcirinble A 


woi printed RraT, I 


ien tkia 


message "TIMES 


5 EQUAIS", 


-inrl 


t™> 


T the rnlculrtinn. 


multiply 


variable A 


oy 5 <A*j; 

















Calculations ore important in most programs. You have a choice of 
using "actual numbers" or variables when doing cniciiLirions, bjr if 

you're working with numbers supplied by a user you must use numeric 
variable;, Begin by asking the user to type in two numbers like this: 

10 PRINT "TYPE 2 NUMBERS": IN PUT A: IN PUT B 
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INCOME/EXPENSE BUDGET EXAMPLE 



Ci PRINT '"*"• - -EW3iM:W:[.!',u 




lg. PR1HT"M0HTHLV INCOME" : IHPUT IN 




20 PRINT 




3£ PRINT "EXPENSE CATEGORY 1'" INPUT 


El* 


4C print-expense amount" = input ei 




50 PRINT 




60 PRINT "EXPENSE CHTE3CRY 2" ■ INPUT 


E2$ 


7S PRINT "EXPENSE AMOUNT " ■ INPUT EZ 




SQ PRINT 




9>@ PR I NT "EXPENSE CflTECCP.Y 3" = INPUT 


£39 


iSe PRINT"EXPENSE BMOUNT" '• INPUT E3 




no print "n^ — gTOl (jflfflj^i 




120 E-EH-E2+E3 




136 EF=EVIN 




140 PR I NT "MONTHLY INCOME J *"IN 




130 PRINT' TOTRL EXPENSES ■ *"E 




160 PRINT l: £flLRNCE IQUflLS = *"IN-E 




17<3 PRINT 




190 PRINT E1*"B"<E1/E>»10ei"f: OF TOTRL EXPENSES 


ISO PRINT E2£"~" CE2/EJ*10W^ OF T0TR1... EXPENSES 


200 PRINTE3*"**'CE3/E>*100-5i OF TOTAL EXPENSES" 


£16 PRINT 




220 PRINT"YQUR EXPENSES- "EP*lGe , K OF YOUR TOTFI 


INCOME" 




230 FOR :«:= 1 TO50BB ' NEXT ! PR I NT 




240 PRINT' REPEAT? f.V JR NV : INPUT ' 


i»S*. IF Y*<="V" 


2=B PRINT 'TJ' ; ENII 




'-ffilTajMlrMM'N 





THEN5 



NOTE: IN con NOT = 0, and El, E2, E3 ton NOT till lie yi the same lime. 
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L1NE-BY-UNE EXPLANATION OF 
INCOME/EXPENSE BUDGET EXAMPLE 



Line(s) 


Description 


5 


Clears the screen. 


TO 


PRINT/INPUT statement. 


20 


Inserts blank line. 


30 


Expense Category 1 = tl$. 


40 


Expense Amount = El. 


50 


Inserts blnnk line. 


60 


Expense Category 2 = E2$. 


70 


Expense Amount 2 = E2. 


80 


Inserts blank line. 


90 


Expense Category 3 = E3$. 


100 


Expense Amount 3 ~ E3. 


no 


Clears the screen. 


120 


Add Expense Amounts = E. 


130 


Calculate Expense/lncome%- 


140 


Dltplay Income- 


150 


Display Total Expenses. 


160 


Displny 1 nenme — f-xpenses. 


170 


Inserts blank ine. 


ISO- 200 


Lines 180— 200 rnlrulate % enrh expense 




amount is of total expenses. 


210 


Inserts hlank line. 


220 


Display E/l %, 


230 


Time de ay loop. 



Now multiply those two numbc-s together to create a new variable C as 
shown in line 20 below: 



20 C=A*B 

To PRiNT the result as a message type 

30 PRINT A "TIMES" B "EQUALS" C 

Enter these 3 lines and RUN the program. Notice that the messages are 
inside the quotes while the variables are not. 
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Now lei's say that you wanted a dollar sign ($) in front of the number 
represented by variable C. The $ must be PKINTed inside quotes and in 
front of variable C. To add the $ to your program hit The 
nnc ^mjQQJ Keyi. Now type in line -10 as follow': 



40 PRINT "$" C 



Now hit ■:mH.M,'E , type GJM and hit ■SilH:)M again. 

The dollar sign goes in quotes because the variable C only represents 
a number end can't contain a $. If the number represented by C was 
100 then lire Commodore 64 screen would display $ 100. But, if you 
tried to PRINT $C without using the quotes, you would get a 75YNTAX 
ERROR message. 

One last tip about $$$? You can create a variable that represents a 
dollar sign which you cot iher substitute for the $ when you want fa jse 
it with numerir vnrtnbles. For example: 

10 Z$="S" 

Now whenever you need a dollar sign you can use the string variable 
Z$. Try ihis: 

10 l£="$":INPUT A 

20 PRINT Z$A 

Line 10 defines the $ as a string variable called Z$ r and then INPUTs a 
number called A. Line 10 PRINTS Z$ (S) next to A (number). 

Yoj'II probably find tha" it's easier to assign certair characters, ike 
dollar signs, ro a string variable nan -o type "$" every time you want to 
calculate dollars or olher items which require " " like %. 



USING THE GET STATEMENT 

Most simple programs use the INPUT statement tc get data from the 
person operating tne computer, Whan you're dealing with more complex 
needs, like protection from typing errors, the GET statement gives you 
more flexibility and your program mora "intelligence." This section shows 
yoj how to use the GET sralenenl 1u udd some speciul screen editing 
features to your programs. 
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The Commodore 64 has a keyboard buffer that holds up to TO char- 
acters, This means that if the computer is busy doing some operation 
nnA it's nnt ronding the keyboard, you can still lype in up TO 10 char- 
acters, which will be used as SOOfl OS the Commodore 64 finishes what it 

wns doing. To demonstrate this, type in this progrcm on your Commo- 
dore 64; 

NEW 

10 Tl$ = "000000" 

20 IF Tl$ < "000015" THEN 20 

Now type RUN, hit Q ond while the progrom Is RUNning type 

in the word HELLO, 

Notice that nothing happened for about 15 seconds when the pro- 
gram started. Only then did the message HELLC appear on the screen. 

Imaaine standing in line for o movie- The first person in the lire is the 
first ta get a ticket and leave the line. The last person in line is last -for a 
ticket. The GET statement acts like a ticket taker. First it looks to see if 
there are any characters "in line." In other words have any keys been 
typed, If thrj answer is yes *hen that character gets placed in the ap- 
propriate variable. If no key was pressed then an empty value is as- 
signed to a variable. 

At this point it's important to note that if you try to put more than 10 
characters Into the buffer at fine time, ell those over the 10th character 
wi I be lost. 

Since the GET statement will keep going even when no character is 
typed, it is often necessary to put tne GET statement into a loop so that it 
will have to wait until someone hit? a key or until a character is received 
through your program. 

Below is the recommended form for the GET statement. Type NEW To 
erase your previous program. 

10 GET A$ ; IF A$ = "" THEN 1C 

Notice that rhere is NO SPACE between the quote marks ("") on this line. 
This indicates an empty value and sends the program back to the GET 
statement in a continuous loop until someone hits a key an the computer. 
Once a key is hit the prcgram will continue with the line following ine 
10- Add this line ta your program: 

100 PRINT A$;: GOTO 10 
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Now RUN the program. Notice that no cursor ■ appears on the screen, 
but any character you type will be printed in the screen. This 2~lins 
program con be turned into part of a screen editor pruyrtirri as shown 
below . 

There are many things you can dc with c screen editor. You con have 
a flashing cursor. You con keep certain keys like ■' : ^ from 

accidentally erasing the whole screen. You might even want to be able 
To use your function keys to represent whole words or phrases. And 
speaking of tuncticr keys, the following program lines give each -unc- 
Tion key a special purpose. Remember this is only the beginning of a 
program that you can customize for your needs. 

20 IF At - CHR$(133) THEN POKE 532S0,S;GOTO 10 

30 IF A$ = CHR&134) THEN POKE 53281 ,4:GOTO 10 

40 JF At = CHR$(135) THEN A$='DEAR SIR:" + CHR$(1 3] 

50 IF AS = CHR$(136) THEN A$="5INCEREIY," + CHR$(13) 

The CHSt numbers in oarentheses come from the CHR$ code chart in 
Appendix C. The chart lists a different number for each character. The 
four function key* are set up to perform the taski represented by the 
instructions that follow the word THEM in each line. By changing the 
CHR$ number inside each set of parentheses you cnn designate differ- 
ent keys. Different instructions would be performed if you changed the 
inform ntion nfter the THEN statement. 

HOW TO CRUNCH BASIC PROGRAMS 

You can pack more instructions — and power — into your BASIC pro- 
grams by mukirvuj each prugram a* shurl a* possible. This process of 
shortening programs is called 'crunching" 

Crunching proyrutris lets you squeeze the maximum Possible number 
of instructions into your program. It oho helps you reduce the si?e of 
programs which might not otherwise run in a given size,- arid if you're 
writing a program which requires the input of data such as inventory 
items, numbers or text, a short program wll leave more memory scare 
free to hold data 

ABBREVIATING KEYWORDS 

A list of keyword abbreviations is given in Appendix A, This is helpful 
when you program because you can actually crowd more information on 
each line using abbreviations. The most frequently used ubbreviulion is 
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the question mark (?] which is the BASIC nbbrevintion for the PRINT 
command. However, if you LIST a program that has abbreviations, the 
Commodore 64 will automatically print out the listing with the full-length 
keyword*. If any program line exceeds 80 characters (2 lines an the 
screen) with the keywords unabbreviated, end you want to change it, 
you will have to re-enter thct line with the abbreviations before saving 
the program. SWEing a program incorporates the keywords without 
inflating any lines because BASIC keywords are tokenized by the Com- 
modore 64. Usually, abbreviations are added after o program is written 
and it isn't going to be USTed any mora bsfor^ SAVEing. 

SHORTENING PROGRAM LINE NUMBERS 

Most programmers sta'l their programs at line 100 and number each 
line at Intervals o* 10 (i.e., 100, 110, 120). This allows extra lines of 
instruction to be added (111, 112, etc.) as the program is developed. 
One means of crunching the program after it is completed is to change 
the tins numbers to trie fowest numbers possible (i.e., 1, 2, 3) because 
longei line numbers take more memory than shorter numbers when ref- 
erenced by GOTO and GOSUB statements. For instance, the number 100 
uses 3 bytei cf memory (one for each number) while the number 1 use& 
only 1 byte, 

PUTTING MULTIPLE INSTRUCTIONS ON EACH LINE 

You can put more than one instruction an each numbered line in your 
program by separating them by a colon. The only limitation is that all 
The instructions on each line. Including colons, should not exceed the 
standard 80 -character line length. Here is an example of two programs, 
oefo^e and after crunching: 

BEFORE CRUNCHING: AFTER CRUNCHING: 

10 PRINT "HELLO. . ."; 10 PRINT "HELLO . . .";:FORT = 1TO 

20 FOR T=l TO 500:NEXT 500:NEXT:PRINT"HELLO, 

30 PRINT "HELLO, AGAIN . . " AGAIN . . ."iGOTOlO 

40 GOTO 10 

REMOVING REM STATEMENTS 

REA\ statements arc helpful in reminding yourself — or showing other 
programmers — what a particular secticr of a program is doing. How- 
ever, when the program is completed and ready to use, you probably 
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won't need rhose REM statements anymore and you can soue quite a b't 
o* space by removing the REM statements. If you plan to revise or study 
trie program structure in the future, ifs a good idea +o keep a copy on 
file with the REM statements intact. 

USING VARIABLES 

If a numier, word or sentence s used repeatedly In your program it's 
usual y best to define thuse luny wo-ds or numbe-5 with a one or two 
letter* variable. Numbers cc n be de+inad as single etters. VWjrds and 
Sentences can be defined as string variables using, a letter and dollur 
sign. Here's one example: 

BEFORE CRUNCHING: AFTER CRUNCHING: 

10 POKE 54296,15 10 V = 5429oF =54273 

20 POKE 54276,33 20 POKEV,15:POKE54276,33 

30 POKE 54273,10 30 POKEF,10:POKEF,4C:POKEF,70 

40 POKE 54273,40 40 POKEV.O 

50 POKE 54273,70 

60 POKE 542?6,0 

USING READ AND DATA STATEMENTS 

Large c mounts of data can be typed in as one piece of data at a 
time, over and over again ... or you can print the instructional part of 
the program ONLt and print all the data to be handled in a long run- 
ning list called the DATA statement. This is especially good for crowding 
lege lists of numbers inro a prcgram. 

USING ARRAYS AND MATRICES 

Arrays end matrices are similar to DATA statements In that long 
amounts of daTa can be handled as o lis*, with the data hand ing Nor- 
ton of the orogram drawing from that list, in sequence. Arrays differ in 
that the list car be multi-dimensional 

ELIMINATING SPACES 

One of the easies- ways to reduce the size of your program is to 
eliminate all the spaces, Although we often include spaces in sample 
programs to provide darrtyj you actually don't need any spaces in your 
program and will save space if you eliminate litem. 
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USING GOSUB ROUTINES 

If you use a particulcr line or Insiructian ewer and over, it might be 
wise to GOSUB to the line 'from several places in your program, rather 
than w.-ffe fhe whole ,'ine or instruction every time you use it. 

USINC TAB AND SPC 

Instead of PRINTing several cursor commands to position a character 
on the screen, it is often more ecoriomico! to use the TAB und SPC in- 
structions to position words or characters on the screen. 
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BASIC LANGUAGE 
VOCABULARY 

• Introduction 

• BASIC Keywords, Abbreviations, 
and Function Types 

• Description of BASIC Keywords 
(Alphabetical) 

• The COMMODORE 64 Keyboard and 
Features 

• Screen Editor 



INTRODUCTION 

This chapter explains CBM BASIC Language keywords. First wo give 
you an easy to read list of keywords, th*ir abbreviations und what each 
letter looks Ilka oi th* screen. Than we explain how the syntax and 
operation of each keywod works in detail, and examples ore shown to 
give you on idea as to hew tc use them r, your programs. 

As a convenience, Commodore 64 BASIC allows you to abbreviate 
most keywords. Abbreviations are entered by typing enough letters of 
the keywo'd to distinguish h from all other keywords, with the last letter 
or graphics enTered holding down the Q< | key. 

Abbreviations do NOT sovc any memory when they're used in pro- 
grams, because all keywords are reduced to single-character "tokens" 
by the BASIC Interpreter, When a program containing abbreviations is 
listed, all keywords appear in their ful.y spelled form. You car use ab- 
breviations to put more statements onto a program line even if they 
won't fit onto the 30-character logical screen line. The Screen Editor 
works on an 80-character line. This means that if you uie abbreviations 
on uny line thai yoes ovei 80 L'urutieis, you will NOT be uble lo edil 
that line when LIS Ted. Instead, who* you'll have to do is (1) retype the 
entire line including all abbreviations, or (2) breok the single line of code 
into two lines, each with its nwn line number, etc 

A complete list of keyworoa, abbreviations, and their appearance on 
the, scrppn is prpspnted in Table 2-1. Thf>y an? fnllowetd by an alpha- 
betical description of all the statements, commands, and functions 
available on your Cnrnmodsre 64, 

This chepter alsc explains the BASIC functions built into -he BASIC 
Lunujuage Interpreter, Built-in functions can ye used in direct r node 
statemeriTs or in any program, without having to define the function 
further. This is NOT the case with user-defined functions. The results oT 
built-in BASIC functions can be used as immediate output or they can be 
assigned to a vciriab e name of an appropriate type. There are two 
types of 3ASIC functions: 

1) NUMERIC 

2) STRING 

Arguments of built-in functions ate always enclosed in parentheses 
( ), The parentheses always come directly after the function keyword 
and NO SPACES between the lest letter of the keyword and the left 
parenthesis (. 
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The Type nf argument needed U generol y decided by the data type in 
the result. Functions which return a string value as their result are iden- 
tified by having a dollar sign ($1 as trie last character of the keyword. In 
some cases string furctions contain one or more numeric argument, 

Numeric functions will convert oetween integer and floating-point 
format qs reeded- In the descriptions tha- follow, the data type of the 
value returned is shown w'th each function name. The types of argu- 
ments are also given with the statement format. 



Table 2-1. COMMODORE 64 BASIC KEYWORDS 



COMMAND 


ABBREVIATION 


SCREEN 


FUNCTION TYPE 


ABS 


A miIJi B 


A [E 


NUMERIC 


AND 


A uilii N 


A 




ASC 


a yjy| s 


A @ 


NUMERIC 


ATM 


A gJQ| 1 


A 


NUMERIC 


LH R$ 


c jiiiiSI h 


c 3 


STRING 


CI O.SF 


cl Ems ° 


CL □ 




CLR 


c Kllbl _ 


c □ 




CMD 


c CflTaM M 


c S 




CONT 


C CHT51 O 


c D 




COS 


none 


COS 


NUMERIC 


DATA 


d EE1 A 


d g 




DEr 


D Ulllai E 


D B 




DIM 


D E35I I 


D 3 
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COMMAND 


ABBREVIATION 


SCREEN 


FUNCTION TYPE 


END 


E BBH N 


E 




EXP 


£ tWINl X 


E ® 


NUMERIC 


FN 


rone 


FN 




FOR 


F Ulllai O 


F □ 




FEE 


F Id! hi R 


■= 3 


numeric: 


GET 


G EO F 


o B 




GFT# 


none 


GET# 




GOSUB 


GO 0SI 5 


GO S 




GOTO 


c UMil o 


3 □ 




IF 


none 


IF 




INPUT 


none 


INPUT 




INPUTS 


EQ3 N 


i z 




INT 


none 


INT 


NUMERIC 


LEFTS 


LE i-fflil F 


LE 3 


STRING 


LEN 


none 


LEN 


NUMERIC 


LtT 


L |^bj E 


l a 




LIST 


L 1 9 1 


L S 




LOAD 


i Ij'i jf o 


L □ 




LOG 


ncre 


LOG 


NUMERIC 
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COMMAND 


ABBREVIATION 


SCREEN 


FUNCTION TYPE 


MID$ 


M FHTTal 1 


Art □ 


S 


TRIIsiG 


NEW 


ncre 


NEW 






NEXT 


n fpm e 


n a 






NOT 


n EE1 - ! 


N □ 






ON 


none 


ON 






OPEN 


O Hl'lal p 


o □ 






OR 


none 


OR 






PL"LK 


P UilHI E 


p B 


N 


UMERIC 


POKE 


p EH3 o 


p n 






POS 


none 


P0£ 


Is 


UMERIC 


PRINT 


■> 


o 






PRINT# 


p Ej|g r 


p y 






READ 


R PTH3| E 


■ a 






REM 


none 


REiV, 






RESTORE 


re jsiirai S 


RE (¥] 






RETURN 


3t m|[jj T 


* E LU 






RK3HT5 


r mm i 


« Q 


SI 


RING 


RND 


R fTO M 


■ 


NUMERIC 


RUN 


R gJEH LI 


r a 
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COMMAND 


ABBREVIATION 


SCREEN 


FUNCTION TYPE 


SAVE 


s EffflSl a 


s B 




SGN 


s ESBI G 


s O 


NUA\ERIC 


SIN 


S UTIIil 1 


s 5j 


NUMER C 


SPC( 


s EQi P 


*□ 


SPtCIAL 


5QR 


S BilBl Q 


5 ■ 


NUMERIC 


STATUS 


ST 


ST 


NUMERIC 


STE? 


ST ^j| E 


stB 




STOP 


s B2n ^ 


s (L 




5TR$ 


ST tffllil R 


ST S 


STRING 


SYS 


S Uillii Y 


s a 




TAB( 


yjlU a 


T [* 


-SPECIAL 


TAN 


none 


TAN 


NUMERIC 


THEN 


T |]J|13 H 


T □ 




TIME 


Tl 


Tl 


NUMERIC 


TIME$ 


Tl$ 


Tl$ 


STRING 


FO 


none 


TO 




JSR 


U E1IE1 s 


u H 


NUMERIC 


\AL 


V gggj A 


v B 


NUMERIC 


VERI=V 


V pHllii L 


v □ 




WAIT 


w tiiliil A 


w @ 
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DESCRIPTION OF BASIC KEYWORDS 
ABS 

TYPE; Function-Numeric 
FORMAT; ABS(<expres5ion>) 

Action: Returns the absolute value of the number, which is its value 
wilhout any siyns. The absolute value of a negative number is that 
number multiplied by —1, 

EXAMPLES of ABS Function: 

10 X = ABS ( V ) 

10 PRINT ABS ( X * J ) 

10 IF X = ABS (X) THEN PRINT "POSITIVE" 

AND 

TYPE: Operator 

FORMAT: <expre«ion> AND <expression> 



Actioni AND is used in Boolean operations to teat bits M is also used 
in operations to check the truth of both operands. 

In Boolean algebra, the result of an AND operation Is 1 only if both 

numbers being ANDed are 1 . The result is if either or both is (false), 

EXAMPLES of 1-Bit AND Operation: 

1 ] 

AND AND AND 1 AND 1 



1 



The Commodore 64 performs the AND operation on numbers in trig 
range from — 327o8 to — 327c7. Any fractional values are not used, and 
numbers beyond the range will cause an ?ILLEGAL QUANTITY error 

RASIC lAUSMAr.F VOTABIJl A.RY 35 



message. When converted ta binary -format, ihe -ange allowed yields 16 
bits for ench number. Corresponding bits are ANDed together, forming 
a 16 bit result in the same range. 



EXAMPLES of 16-Bit AND Operation: 



17 
AND ^S>A 



000000030001 00C1 
AND 0000O00D1 10000 10 

{BINARY) 0000000030000000 

(DECIMAL) 



32007 
AND 28761 



o; n lioioooooin 

AND 01 ' 1000001011001 



(BINARY) 01 1 1 0000000000D1 
(DECIMAL) 23673 



— 241 
AND 15359 

11111111 00301 1 1 1 
AND 001T10J111111111 

(BINARY) 001 1101 100001111 

(DECIMAL) 15119 
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When evaluating a number for truth cr falsehood, the computer as- 
sumes the number is true as long as its value isn't 0. When evaluating a 
comparison, it assigns a value of —1 if the result is true, while false has 
a value of 0, In binary format, — 1 Is all l's and is all O's. Therefore, 
when AMDing true/false evaluations, the result wili be true H any bits, in 
rhe result are true. 

EXAMPLES of Using AND with True/False Evaluations: 

50 IF X=7 AND W=3 THEN GOTO TO: REM ONLY TRUE IF BOTH X = 7 

AND W=3 ARE TRUE 
60 IF A AND Q = 7 THEN GOTO 10= REM TRUE IF A IS HON ZERO 

AND Q=7 IS TRUE 



A5C 

TYPE: Function-Numeric 
FORMAT: ASC [ <string> J 

Action: ASC will "eturn a number ^rom to 2S5 which corresponds to 
■he Commodore ASCII value of the first character In the string. The tnhle 
of Commodore ASCII vol Lies is shown in Appendix C. 

EXAMPLES OF ASC Function: 

10 PRINT ASC("Z") 
20 X - ASCC'ZEBRA") 
30 J - ASC(J$) 

If there are no characters in the string, an ?I1LEGAL QUANTITY error 

rccults. Ir the third cxcmple above, if J$~ "", the ASC function will not 
wcrk. The GET and GET# stctement read a CHRS{0) as a null string. To 
eliminate this problem, you should add a CHR${0) to the end of the 
string as shown below. 

EXAMPLE of ASC Function Avoiding ILLEGAL QUANTITY ERROR: 

30 J = ASC(J$ + CHR$(0)> 
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ATN 

TYPE: Function-Numeric 
FORMAT: ATN ( number ) 

Action: Thfs mcthemarical function returns the arctangent of the 
number. The result h the angle fin rudians) whose tangent is the number 
given. The result is always in the range — ml to +tt/2. 

EXAMPLES of ATN Function: 

10 PRINT ATN { ) 

20 X = ATN ( J ) * 180 / ?r : REM CONVERT TO DEOREES 



CHR$ 

TYPE: Function-String 
FORMAT: CHR$ ( <number> ) 

Action: This function converts o Cctmmodore ASCII code to its char- 
ucter equivalent. See Appendix C lor a list of characters and Their 
codes. The number must have a value between and 255,, or an ?IL- 
LEGAL QUANTITY error message results. 

EXAMPLES of CHR5 Function: 

10 PRINT CHR$<©5) , REM 65 = UPPER CASE A 

20 A$ = CHR$(T3) : REM 13 = RETURN KEY 

50 A = ASC{A$> i AS = CHR$(A)> REM CONVERTS TO C64 ASCII 
CODE AND BACK 
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CLOSE 

TYPE: I/O Statement 

FORMAT: CLOSE <file number> 

Action: This statement shuts off any data file or channel to a device, 
The file number is the same cs when the file or device was OPFNed [see 
OPEN statement and the section on INP'JT/OUTPUT programming). 

When working with storage devices like cassette rape and disks, the 
CLOSE operation stares any incomplete buffers to the device. When this 
is not performed, the file will be incomplete sn the tape and unreadable 
on the disk. The CLOSE ope'afian isn't as necesscry with other devices, 
but it does free up memory for other files. See your ewernol device 
mnnucil for more details. 

EXAMPLES of CLOSE Statement: 

10 CL05E 1 
20 CLOSE X 
30 CLOSE r(l + J ) 

CLR 

TYPE; Statement 
FORMAT; CLR 

Action: This statement makes available RAM rremory that had been 
used but is no longer needed. Any BASIC program in memory is un 
touched, but all variables, arrays, GOSUB addresses, FOR. . . NEXT 
loops, user-defined functions, ond files are erosea from memory, and 
their space is made available to new variables, etc. 
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In the case of files to the disk Jnd cjsselte tupe, they are not p-operly 
CLOSEd by the CLR statement. The informaton about the files is lost to 
the computer, including any incomplete Luffers. The disk drive will still 
think the File is OPEN. See the CLOSE statement for more information on 
this. 

EXAMPLE of CLR Statement: 



10 X=25 
20 CLR 
30 PRINT X 

RUN 


READY 



CMD 



TYPE: I/O Statement 

FORMAT: CMD <file number> [ , string ] 



Action: This statement switches the primary output cevice from the TV 
screen to the file specified. This file could be on disk, "ape, printer, or on 
I/O device like the modem. The fl e number must be specified in a prio' 
OPEN statement, [he string, when specified, is sent to the file. This is 
handy *or titling printouts, etc. 

When this rommand is in effect, any PRINT Statements ord LIST com- 
mends will not display on the Screen, but will send the text In the same 
forma* to the file. 

To re-direct the output bacU to the screen, the PRINT# commard 
should send a blank line to the CMD device before CLOSEing, so it will 
stop expecting data (called "un listening" the device). 
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Any system 1 error (like OSYNTAX ERROR) will co use output to return to 
the screen. Devices aren't un-listened by this, so you should send a 
blank lire after an error condition, (See your printer or disk manual -for 
more details.) 

EXAMPLES of CMD Statement: 

OPEN 4, 4: CMD 4, "TITLE" : LIST; REM LISTS PROGRAM ON PRINTER 
PRINTS 4: CLOSE 4: REM UN-LISTENS AND CLOSES PRINTER 

10 OPEN 1, 1, I, "TEST": REM CREATE SEO FILE 

20 CMD li REM OUTPUT TO TAPE FILE, NOT SCREEN 

30 FOR L - I TO 100 

40 PRINT L: REM PUTS NUMBER IN TAPE BUFFER 

50 NEXT 

60 PR,INT# 1: REM UNLISTEN 

70 CLOSE 1: REM WRITE UNFINISHED BUFFER, PROPERLY FINISH 



CONT 

TYPE: Command 
FORMAT: CONT 

Action. This command re-starts the execution of a program which was 
halted by a STOP or END staterneril ur the ^ : ^ key being 
pressed The progrom will re-start a1 the exact place from which it left 
off. 

Wtiie the program is stopped, the user cnri inspect or change any 
variables or look at the program. When de-bugging or examining a 
program, STOP stntements can be pinned nt strategic locations, tn a flow 
examination of variables and to check the flow of the program. 

The error message CAN'T CONTINUE will result from editing the 
program (even fust hitting | ;i: R Vi | with the cursor on an unchanged 
lire), or if the program haired due to an error, or If you caused an error 
before typing CONT to re-start the program, 

EXAMPLE of CONT Command: 

10 PI=0:C = 1 

20 PI = PI+4/C-4/{C-l-2) 

30 PRINT PI 

40 C = C+4:GOTO 20 
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This program calculates the value of PI. RUN this program, and a-fer 

a short while hit the C: v, - ~ r\ key. You will see the display; 



BREAK IN 20 



r40TE: Wight h* diHsrent number, 



Type the command PRINT C to see how for the Commodore 64 has 
gotten. Then use CONT to resume from where the Commodore 64 left 
off. 



COS 

TYPE; Function 

FORMAT: COS ( < number> ) 

Action; This mntheTmticnl -unction calculates the cosine of the 
njmber, where the number is an angle in radians. 

EXAMPLES of COS Function; 

10 PRINT COS ( ) 

20 X = COS ( Y * Tt I 180 ) ; REM CONVERT DEGREES TO RADIANS 



DATA 

TYPE: Statement 

FORMAT: DATA <lisl of constants > 

Action: DATA ^Interments store information within a program. The 
program LrSci the information by means of the READ statement, which 
pulls successive constants from the DATA statements. 

The DATA statements don't have to be executed oy the prograrn, they 
only have to be present. Therefore, they are Lsuolly placed at the end of 
the program. 

All dcita statements in a program ere treated as c continuous list. 
Data ts READ frorr [eft *o right, from the lowest numbered line to the 
highest If the R£AD statemerr encounte-s data that doesn't fir The type 
requested (if it needs a number and firds a string) an error message 
occurs. 
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Any characters can be included as data, but if certcin ones are used 
The data item mus* be enclosed by quote marks (" "). These include 
punctuation like comma (,), colon (:) r blank spaces, and shifted letters, 
graphics, and cursor control characters, 

EXAMPLES of DATA Statement: 

TO DATA T r 10, 5, 8 

20 DATA JOHN, PAUL, GEORGE, RINGO 

30 DATA "DEAR MARY, HOW ARE YOU, LOVE, BILL" 

40 DATA -5.7E-9, 3.33 



OEF FN 



TYPE: Statement 

FORMAT: DEF FN <iwme> ( <variable> ) = Expres- 
sion > 



Action: [his sets up a user-defined function that can bo used later r 
the program. The funtlion con consist of any marhematcal formula. 
Utec-def ned functions save space in programs where a long formula is 
Lsed in several places. The formula need only be specified once, in the 
definition statement, and than it is abbreviated as a function name, It 
mus* be executed once, but any suysenuent executions are Ignored, 

The function name is the letters FN followed qv guy variable name. 
This can be 1 or 2 characters,, the first being a letter and the second u 
letter or digit. 

EXAMPLES of DEF FN Statement: 

10 DEF FN A (X) = X + 7 
20 DEF FN AA (X] - Y * Z 
30 DEF FNA9 (Q) = INT( RND( 1 ) + Q+ 1) 



The function is called later in the program by using the function name 
with a variable In parentheses. This function name is used like any other 
variable, and its value h automatically calculated, 
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EXAMPLES of FN Use: 

40 PRINT FN A (9) 

50 R - FNAA (?) 

60 G = G + FN A9{10) 

In line 50 ubove, the number 9 inside the parerrheses does not affect 
the outcome of the function, because the function definition in line 20 
doean'l use the vurioble in the parentheses. The result is Y times Z, 
regardless of the value of X. Jn the other two functions, the va'ue in 
parentheses does affect the result. 



DIM 

TYPE; Statement 

FORMAT; DIM <variable> { <subscripts> } [ , 
<variable> ( <subscripts> ) . . . ] 

Action: This statement defines nn nrroy or matri* <yf vnrinhles. This 
ollow& you to use the varicble none with a subscript. The subscript 
points ro the element being used. The lowest element number in an 
array is zero, and the highest is the number given in the D'M statement, 
which has a maxiiium of 32767. 

The DIM statement must be execjted once and only once for each 
array. A REDIM D ARRAY error occurs if this Ine is re-executed. There- 
fore, most programs perform all DIM operations at the very beginning, 

There may be any number cf dimensions and 255 subscripts in an 
array, limited only by the amount of RAM memory which is available to 
hold the variables, The unuy may be made up of normal numeric vari- 
ables, as shown above, or of strings or integer number*. If the variables 
are other than norma! numeric, use the $ or % signs after the variable 
name to indicate string or nteger variables, 
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If an array referereed h a program was never Dimensioned, it is 
automatically dimensioned 1o 1 1 elements in eoch dimension used 1r. the 
first reference. 

EXAMPLES of DIM Statement: 

10 DIM A ( 100 ) 

20 DIM Z { 5, 7), Y ( 3, 4, 5] 

30 DIM Y7% { Q > 

40 DIM PHS (1000) 

50 F (4) =9: REM AUTOMATICALLY PERFORMS DIM F (10) 

EXAMPLE of FOOTBALL SCORE-KEEPING Using DIM: 

10 DIM 3(1,5), TS(1) 

20 INPUT 'TEAM NAMES"; T$(0), T$(1) 

30 FOR Q=l TO 5: FOR T=0 TO 1 

40 PRINT T$(T), "SCORE IN QUARTER" Q 

50 INPUT S(T,Q>: S[T,0)- S(T,0]+ S(T,Q) 

60 NEXT T,Q 

70 PRINT CHR$(147> "SCOREBOARD" 

80 PRINT "QUARTER" 

90 FOR Q-l TO 5 
100 PRINT TAB( Q + 2 +9) Q; 
110 NEXT: PRINT TA&{15) "TOTAL" 
120 FOR T = TO 1: PRINT T$<T); 
130 FOR Q = l TO 5 
140 PRINT TAB(Q*2 +?) S(T,Q); 
150 NEXT: PRINT TAB(U) S(T,0> 
160 NEXT 

CALCULATING MEMORY USED BY DIM: 

5 bytes for the array dome 
2 bytes for each dimension 

2 bytes/element for integer variables 

5 bytes/element for normal numeric variables 

3 bytes/element for string variables 

1 byte for each character in each string element 
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END 



TYPE: Statement 
FORMAT: END 

Action: This finishes a program's execution and displays the READY 
message, returning control to the person operating the compjrer. There 
may be any number of END statements within a program. While it is not 
necessary to include uny END statements at all, it is recommended that 
a program does conclude with one, rather than just running out of lines, 

The END statement is similar to the STOP statement. The only differ- 
ence is that STOP caussi the computer to display the message BREAK 
IN LINE XX and END jus! displays READY. Bo?h statements allow the 
computer to resume execution by typing the CQNT command. 

EXAMPLES of END Statement: 

10 PRINT "DO YOU REALLY WANT TO RUN THJ5 PROGRAM" 

20 INPUT A? 

30 IF A$ - "NO" THEN END 

40 HEM REST OF PROGRAM , , , 

999 END 



EXP 

TYPE: Function-Numeric 
FORMAT: EXP ( <number> ) 

Action; This mathematical function calculates the constant e 
(2.71828183} raised to the power of the number given, A value greater 
thon 88.0296919 causes an ?OVERFLOW error to occur. 

EXAMPLES of EXP Function: 

10 PRINT EXP (1) 

20 X = V" * EXP (Z * Q} 
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FN 

TYPE; Function -Numeric 

FORMAT: FN <nnme> ( <number> ) 

Action: This function references the previously DEFined formula spec- 
ified by name. The number is substituted into its place (if any) and (lie 
formula is calculated. The result will be n numeric value. 

This function can be used in direct mode, as long as the statement 
DEFining it has been executed. 

If an FN is executed before the DEF statement which defines it, an 
UNDEFD FUNCTION error occurs. 

EXAMPLES of FN (User-Defined) Function; 

PRINT FN A { Q > 

1100 J = FN J (7} + FN J (9) 

9990 IF FN B7 (1 + 1)= 6 THEN END 

FOR . . . TO . . . [STEP ... J 

TYPE: Statement 

FORMAT; FOR <variable> = <start> TO <limit> [ STEP 
<ineremenf> ] 

A<tion: This is a special BASIC statement that lets you easily use a 
variable as a counter. You must specify certain parameters: the 
floating-point variable name, its stnrting value, the limit of rhe count, 
and how much to add during each cycle. 

Here is a simple AASIC program that counts from 1 to 10, PRINTing 
each number ana ENDing when complete, and using no FQK state- 
ments: 

100 L = 1 

110 FRINT L 

120 L = L + 1 

130 IF L <- 10 THEN 1 10 

140 END 
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Using the FOR statement, here is the same program: 

100 FOR L - 1 TO 10 
110 PRINT L 
120 NEXT L 
130 END 

As you can see, the program is shorter and easier to understand using 
the FOR statement. 

When the FOR sta'ement is executed, several operations take place, 
The <start> value is placed in the <varicble> b«ing used in the 
counter. In the example above, a 1 is placed in L 

When the NEXT statement ii reached, the < increment > value is 
added to the <variable>. If a STEP was rot included, the <increment> 
is set to +1. The firsl time the program above hits line 120, 1 is added 
to L, so the new value of L is 2. 

Now The vaue in the <variable> is compared to the <llmit>. If the 
<l!m'rt> has not been reached yet, the program GOes TO the line after 
the original FOR statement. In this case, the vclue of 2 in L is Irss then 
the limit of 10, so it GOcs TO line 110. 

Eventualy, the value of < imit> is exceeded by the <variable>. At 
that time, the loop is concluded and the program continues with the line 
follcwing the NEXT statement, In our example, the value of L reaches 
1 1 , which exceeds the limit of 10, and the program goes on with line 
130, 

When the value of ^increment ."> ie positive, the <^variable^> mj?t 
exceed the <limil>, and when il is negative i1 must become less than 
the <limit>. 



NOTE: A loop ol-vdys executes ot leost ence. 



EXAMPLES of FOR. , .10, - STEP. . .Statement! 

100 FOR L = 100 TO STEP -I 
100 FOR L = PI TO 6*n STEP .01 
1 00 FOR AA = 3 TO 3 
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FRG 

TYPE: Function 

FORMAT: FRE ( <variable> ) 

Action; This function tells you how much RAM is available for your 
program and its variables, If o program Tnes to use more space Than is 
available, the OUT OF MEMORY error results. 

The numbe' in parentheses cart have any value, and it is rot used irt 
the calculation. 



NOTE; If the result of FRE I* rtegctiva, add &£536- to ihe FRE number to get the 

number of byte* available in memory. 



EXAMPLES of FRE Function: 

PRINT FRE ( ) 

10 X = ( FRE < K ) - 1000 )/ 7 

950 iF FRE ( Q ) < 100 THEN PRINT "NOT ENOUGH ROOM" 



NOTE: The fo lowing always tells you the current available RAM: 
PRINT FRE(0) - (FRE(Q) < 0)" o553o 



GET 

TYPE: Statement 

FORMAT: GET <variable list> 

Action: This statement reads each key typed by the user, As the user 
is typing, the characters are stored in the Commodore 64's keyboard 
buffer. Up to 10 characters are stored here, and any keys struck after 
the 10th are lost. Reading one of the characters with the GET statement 
makes room for another character. 

If the GET statement specifies numeric data, and the user types a key 
ol-her than c number, ihc message ?SYNTAX ERROR appears. To be 
safe, read the keys as strings and convert them to numbers later. 
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The GET statement con be used *o avoid some of the i imitations of the 
INPUT statement. For more on this, see the section an Using the GET 
Statement in the Programming Techniques section. 



EXAMPLES of GET Statement: 

10 GET A%: IF A$ = "" THEN 10= REM LOOPS IN 10 UNTIL ANY KEY 

HIT 
20 GET AS, BS, CS, D$, ES. REM READS 5 KEYS 
30 GET A, A$ 



GET# 



TYPE; I/O Statement 

FORMAT: GET# <file number>, <variable list> 



Action: This statement reads characters one -at- a -time from the device 
or file specified. It works the same as the GET statement, except thot the 
date comes from a different p ace than the keyboard. If no character is 
received, the variable is set to an empty string (equal to "") or to D for 
numeric variables. Characters used to separate data in files, like the 
cotrma L) or | fj key code [ASC code of 13), ore received like 
ony other character. 

When used with device #3 (TV screen], this statement will read char- 
acters one oy one from the screen, Each use of GET# moves the cursor l 
posttion to the right. The character at the end of the logical line is 
changed to a CHR$ 413), the ■] I key code. 



EXAMPLES of GET# Statement: 

5 GET# 1, A$ 

10 OPEN \, 3: GET# 1, 27$ 

20 GET# 1, A, B, Cl, D$ 
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GOSUB 

TYPE.- Statement 

FORMAT: GOSUB <line number> 

Action: This ia a specialized form of the GOTO statement, with one 
impo'tart difference? GOSUB remembers where it came From. When the 
RETURN statement (different frjm the | | key on the keyboard) 

is reached in the program, the program lumps back to the statement 
immediately following the oriyinul GOSUB statement. 

The major use ct a subroutine (GOSUB really means GO to a SUB- 
icutitie) is when a small section of program is used by different sections 
of the program. By using subroutines rather than repeating tie same 
lines over and over at different places in the p'XKj-arn, you can save lots 
of program specs. In this way, GQSUB Is similar to DfcF l-N, t>fc> FN lets 
you save space when using a fo'mula, while GOSUB saves space when 
using a several-line routine. Here is an inefficient program that doesn't 1 
use GOSUB: 

100 PRINT "THIS PROGRAM PRINTS" 

110 FOR L = 1 TO 500 : NEXT 

120 PRINT "SLOWLY ON THE SCREEN" 

1 30 f OR L = 1 TO 500 : NEXT 

HO PRINT "USING A SIMPLE LOOP" 

150 FOR L = 1 TO 500 = NEXT 

160 PRINT "AS A TIME DELAY/' 

170 FOR L = 1 TO 500 : NEXT 

Here is fhe same program using GOSUB: 

100 PRINT "THIS PROGRAM PRINTS" 

110 GOSUB 200 

120 PRINT "SLOWLY ON THE SCREEN" 

T30 GOSUB 20D 

140 PRINT "USING A SIMPLE LOOP" 

150 GOSUB 200 

160 PRINT "AS A TIME DELAY." 

170 GOSUB 200 

180 END 

200 FOR L = 1 TO 500 • NEXT 

210 RETURN 

BASIC 1ANCUAC6 VOCABUWRV si 



Each time ihe program executes v GOSUE, the line number and posi- 
tion in the program line are saved in a special area called the "stack," 
which takes up 256 bytes, of yaur memory. This limils the umourit of data 
that ccin be stored in the stock. Therefore, the number of subroutine 
return addresses thot can be stored is limited, and core should be taken 
to make sure every GOSUtS hits the corresponding KETUKN, or else you'll 
run cut of memory even lliuugh you have plenty of bytes free. 

GOTO 

TYPE: Statement 

FORMAT: GOTO <Iine number> 

or GO TO <line number> 

Action; This statement allows the BASIC program to execute lines out 
of numerical order. The word GOTO followed by ci numbe" will make 
the program jump to the line with that number. GOTO NOT followed by 
a number equals GOTO 0. It must haue the line number after the word 
GOTO. 

IT is possible to create loops with GOTO that will never and. The 
simplest example of this is a line that GOes TO itself, like 10 GOTO 10. 
~fiese loops can be s'opped using the HUBHTJp key on the key- 
board, 

EXAMPLES of GOTO Statement: 

GOTO 100 
10 GO TO 50 
20 GOTO 999 



IF . . . THEN . . . 

TYPE; Statement 

FORMAT: IF <expression> THEN <line number> 
IF <expression> GOTO <iine number> 
IF < expression- THEN <statements > 

Action: This is the statement that gives BASIC most of iTS "intelli- 
gence," the ability to evaluate conditions and take different action; do 
pending on the outcome. 
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The word IF is followed by on expression, which can include varia- 
bles, strings, numbers,, comparisons, and logical operators. The word 
THEN appears on fne same line and is followed by ©frh«r a line number 
or one or more BASIC statements. When the expression is false, every- 
thing after the word THEN on that line is ignored, and Execution con- 
tinues with the next line number in the program, A true -esult makes the 
program either branch to the line number after the word THEN or exe- 
cute whatever other BASIC statements art found on that line. 



EXAMPLE of IF. . .GOTO. . .Statement: 

TOO INPUT 'TYPE A NUMBER"; N 

110 IF N <= GOTO 200 

120 PRINT "SQUARE ROOT=" SQRfN) 

130 GOTO 100 

200 PRINT "NUMBER MUST BE >0" 

210 GOTO 100 

This program prints out the square root ot any positive number. The IF 
statement here is used to validate the result of the INPUT, When the 
result of M <= is true, the program skips to line 200, and when the 
result is false the next line to be executed is 12D. Note that THEN GOTO 
is not needed with IF. . .THEN, as in line 110 where GOTO 200 actually 
means THEN GOTO 200. 



EXAMPLE OF IF. . . THEN. . Statement: 

100 FOR L = 1 TO 100 

110 IF RIMO0) < ,5 THEN X = X+ 1 • GOTO 130 

120 Y - Y I 

130 NEXT L 

140 PRINT "HEADS = " X 

150 PRINT J TAILS = " Y 

The IF in line 110 tests a random number to see if it is less than .5. 
When the result is true, the whole series of statements following the 
word THEN are executed: first X is incremented by T, then the program 
skips to line 130. When the result is false, the program drops to rhe next 
statement, line 120. 
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INPUT 

TYPE: Statement 

FORMAT: INPUT [ "< prompt >" ; ] < variable liif> 

Action: This is a statement that lets the person RUWning the prograrr 
' Teed" information into the computer. When executed, this statement 
PRIIsTs a question mark (?) on the screen, and positions the cursor 1 
space to the right qf the question mark. Now the compute' waits, cursor 
blinking, for the operator to type in the answer and press the I 
key. 

The word IMPUT may be followed by any text ccrtained in quote 
marks ( " " I. This text is PRINTed on the screen, followed by the ques- 
tion mark. 

After the text comes a semicolon (,) and the name of one or Ticre 
variables separated by camrnes. This variable is where the computer 
stores the information that the operator type;. The variable can be any 
legal variable name, and you can hove several different variable 
names, each for a dfferenl input. 

EXAMPLES of INPUT Statement: 

100 INPUT A 

110 INPUT B, C, D 

120 INPUT "PROMPT"; E 

When this program RUNs,the question mark appears to prompt the 
cpe rotor that the Commodore 64 is expecting on input for line 100 Any 
number typed in goes into A, for later use in the prog'arr. If the answer 
typed was not a number, the ?REDO FROM START message appears, 
wheh means that a string wes received when a number was expected. 
If the operator just hits | | without typing anything, the vari- 

able's value doesn't change. 

Now the nexl question mark, for lire 110, appears. If we type only 
one number and hit |Q | , ths Commodore 64 will now display 2 

question rnurks (??], which meens mat mote input ii required, You tan 
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just type as many Inputs as you need separated by commas, which 
presents the double question mark from appearing. If you type mere 
data than the INPUT statement requested, the ?EXTRA IGNORED mes- 
sage appears, which means that the extra items yo.i typed were not put 
into any variables. 

Line 120 displays the word PROMPT before the question mark ap- 
pears. The semicolon is required between the prempt and any lis: of 
variable*. 

Th« INPUT statement can never be used outside a program. The 
Commodore 64 needs space for a bjffer for the INPUT variables, the 
same space that is used for commands. 

INPUT# 

TYPE; I/O Statement 

FORMAT: INPUT# <file numher> , <variable list> 

Action: This is usualy the fastest and easiest way to retrieve data 
storec In a file on disk or tope. The data is in the form of whole vari- 
ables of up to SO characters in length, as opposed to the one-ar-a-t me 
method of GET#. First, the file must have been OPENed, then INPUT* 
can fill the variabes. 

The INPUT# command assumes a variable is finished when it reads □ 
RETURN code (CHR$ (13)), a comma (,), semicolon (;}, or colon {:;. 
Quote marks can be used to enclose these characters when writing if 
they are needed (see PRINT# statement). 

If the variable type used is numeric, and nan-numeric characters are 
received, a BAD DATA error results. INPUT# can read strings up to 80 
characters long, beyord which a STRING TOO LONG error results. 

When used with oevice #3 (the screen), this statement will read an 
entire IrjQicnl line and move the cursor down to the nest line. 

EXAMPLES of INPUT# Statement: 

10 INPUT# 1, A 

20 INPUT# 2, AS, B3 
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INT 



TYPE: Integer Function 
FORMAT: INT (<numeric>) 

Action: Returns the integer value of the expression. If the expression 
is positive, the fractional part is left off, If the expression is negative, 
ciry fraction causes the next lower integer to be returned. 

EXAMPLES of INT Function; 

120 PRINT INT(9P,4W3), INT(-12.34) 
99 -13 

LEFT$ 

TYPE: String Function 

FORMAT: LEFT$ {<string>, <integer>) 

Action. Returns a string comprised of the laftmost <^integeri> char- 
ucters of the <strine;>. The integer argument vqIls must be in the 
range- t= 255 If the integer is greater than the lergth of the string, the 
entire string will be returned. If an <intege">" value of zero is used, 
then a null stn'ng 'of zero length) is returned. 

EXAMPLES of LEFT$ Function: 

10 A$ = "COMMODORE COMPUTERS" 
20 B$ = LEFT$(A$,9): PRINT B$ 
RUN 

COMMODORE 
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LEN 

TYPE: Integer Function 
Format: LEN (<string>J 

Action: Returns the number of characters in the string expression. 
Non-printed characters and blanks are counted, 

EXAMPLE of LEN Function; 

CC* = "COMMODORE COMPUTER", PRINT LEN(CC$J 

18 



lei 

TYPE: Statement 

FORMAT: TLET] <varioble> = Expression > 

Action; The LET statement can oe used to assign a value to a vari- 
able. But the word LET is optional and therefore most advanced pro- 
grammers leave LET out because It's always unde-stood and wastes val- 
uable memory . The equal sign (=) alone is sufficient when assigning the 
value ot an expression to a variable name. 

EXAMPLES of LET Statement: 

10 LET L> = 12 (This is the same as D = 12) 

20 LET E$ = "ABC" 

30 F$ = "WORDS" 

40 SUM$ = E$ + F$ ISUM$ would equol ABCWORDS) 
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LIST 

TYPE: Command 

FORMAT: UST IT<first-line>]-[<last-lin e >j] 

Action: The LIST command allows you to look at lines of the BASIC 
program currently in the memory of your Commodore 64. This lets you 
us.tr your computer's powerful Screen editoi to edit programs which 
you've LISTed both quickly and easily. 

The LIST system command displays oil or part of the program that is 
currently in memory on the default output device. The LIST will normally 
be directed to the screen and the CMD statement con be used to switch 
output To on external device such as a printer or n disk The UST com- 
mand car, appear in a program, but BASIC always returns to the system 
READY mwsngs ofter a LIST is executed. 

When you bring the program LIST onto the screen, the "scrolling" of 
the display from the bottom of the screen to ihe top can be slowed by 
holding down the ConTRoL | | key. LIST is aborted by typing 
the ^F^^^ key 

If no fine-numbers are given the entire prog-am. is listed. If only the 
ftrst-lne number is specified, anc followed by a hyphen (-), that line and 
all higher-numbered iines are listed. If only the last line-number is spec- 
ified, and it is preceded by a hyphen, then ell fines from tie beginning 
ot the program through that line are listed. If both numbers ar& spec- 
ified, ihe entire range, including the 'ine-numbeis LISTed, is displayed, 

EXAMPLES of LIST Command: 

II5T (Lists the program currently in memory.) 

LIST 500 (Lists line 500 only.) 

LIST 150- (Lists alf lines from 150 to the end.) 

LIST -1000 (Lists all lines from the lowest through 1000.) 

LIST 150-1000 (Lists lines 150 through 1000. inclusive.) 

10 PRINT "THIS IS LINE TO" 

20 UST (L[ST used in Program Mode) 

30 PRINT 'THIS 15 LINE 30" 
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LOAD 



TYPE: Command 

FORMAT: LOAD ["<file-name> "] [, <devite 
[,<address>] 



Action: The LOAD statement reads The contents of a program file from 
tope or disk into memory. Thai way you can use the information LOADed 
or change the informat'on in some svay. The device number is optional,, 
but when it is left out the computer will automatically default to I, the 
cassette unit. The disk unit Is normally device number 8. The LOAD 
doses all open files and, if it is used in direct mode, it performs a CLR 
(clear) before reading the program, If LOAD is executed from within a 
program, the program is RUN. This means that you cor. use LOAD to 
"chain" several programs together. None of the variable; are cleared 
during n chain operation. 

If you are using file-name pattern matching, the first file whkJl 
matcnes the pattern is loaded. The asterisk in quotes by itself ("*") 
causes the finst file-name in the disk directory to be loaded, if the file- 
name used does no- exist or if it is nat a program file, the BASIC error 
message ?FILE NOT FOUND occurs. 

When LOADing programs from Tape, the <file-name> can be left 
out, and the nexl program file on the tape will be read. The Commodore 
o4 will blank, the screen to the border color after rhe PLAY key is 
pressed. When the program is found, the screen cears to the back- 
y round color and the 'FOUND" message h displayed. When the 
key, Q3 key, Q key, or ^^323 ' s pressed, the file will 
be loaded. Programs will LOAD starling ai memory location 2048 unless 
c secondary <oddreSs> of 1 is used, If you use the secondary oddrcss 
of 1 this will cause "he program to LOAD to the memory location from 
which it was saved. 
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EXAMPLES of LOAD Command: 

LOAD (Regd; the next program on tape) 



LOAD A$ 



(Uses the nome in A$ to search) 



LOAD "*",8 



(LOADs first program from disk) 



LOAD "",1,1 



(Looks for the first program on 
tape, and LOADs 11 into the same 
part of memory that it came 
from) 



LOAD "STAR TREK" 
PRESS PLAY ON TAPE 
FOUND STAR TREK 
LOADING 
READY 



(LOAD a file from tape) 



LOAD "FUN",S 
SEARCHING FOR FUN 
LOADING 
READY. 



(LOAD a file from disk) 



LOAD "GAME 0NE",8,I (LOAD a file to the specific 

SEARCHING FOR GAME ONE memory location from which the 

LOADING program was saved on the disk) 
READY. 
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LOG 

TYPE: Floating-Point Function 
FORMAT: LOG (<numerie>) 

Action: Returns the natural logarithm flog to the base of c) of the 
argument. If the value of the argument is zero or negative The BASIC 
error message 7ILLEGAL QUANTITY will occur, 

EXAMPLES of LOG Function; 

25 PRINT LOGW5/7) 
1.36075234 

10 NUM = LOG(ARG) / LOGflOJ (Calculates the LOG of ARXS to the 

hose 10) 

MID$ 

TYPE: String Function 

FORMAT: MID$ (<string>, <numerie-1> [,<numerk- 
2>]) 

Action: The MID$ function returns a sub string which is take?! from 
within a larger <string> argument. The sicrrlng position of the sub- 
string is defined by the <numeric-l> argument and the length of tie 
sub-string by the <numeric-2> argument. Both of The numeric argu- 
ments can have values ranging from to 255. 

If the <numerlc-l> value is greater then the length of the <5lring>, 
or if the <numeric-2> value is zero, then MIDJ gives a null string value. 
If the <numeric-2> argument is Ml out, then the computer will assume 
that a length ot the rest of the str ng is to be used. And if the source 
siring has fewer character; than <numeric-2>, from the starting posi- 
tion to the end of the string argument, then the whale rest of The sTring is 
used. 

EXAMPLE of MID$ Function: 

10 A$="GOOL>" 

20 B$="MORNING EVENING AFTERNOON" 

30 PRINT A$ - MID$(B$. 8, 8) 

GOOD EVENING 
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NEW 

TYPE; Command 
FORMAT: NEW 

Action: The NEW command is used to delete the program currently in 
memory and clear ell variables. Before typing in a new program. NEW 
should be used in direc mode to dear memory. NEW can olso be used 
in a program, but you shnulc bp awnrf? nf the fact that it will prase 
everything that has gone before and is still In the compute's memory, 
This con be particularly troublesome when you're trying to debug your 
program. 



BE CAREFUL N«>t clearing out <?n old program b&^ere typing a new ana can result i 
o confusing mix of the two programs. 



EXAMPLES of NEW Command: 

NEW [Clears the program and all variables) 

10 NEW (Performs a NEW operation and STOPs the program.) 

NEXT 

TYPE: Statement 

FORMAT: NEXT [<cpunter>l [,<«unter>l .... 

Attion: The NEXT statement is jsed with FOR to establish the end of a 
FOR, , , NEXT loop. The NEXT need not be physically the last statement 
in the loop, but it is always the last statement executed in a loop. The 
<counter> is the loop index's variable name used with FOR to start the 
loop, A single NEXT nan stop several nested loops when ir is followed by 
each FOR's <counter> variable namels). To dc this each nome must 
appear in the order of inner-must rifled loop first, ty outer-most rested 
loop lost. When using a single NEXT to increment and itop severa' vari- 
able names, each voriuble nurne nusl be sepurated by tomnius, Loops 
can be nested to 9 levels. If toe cojntsr varicibie(5; ore omitted, the 
counter associated with the FOR of the current level (of me nested loops) 
is incremented. 
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When the NEXT is readied, the counter value Is incremented by 1 or 
by an optional STEP value. It is then tested against an end-value to see 
if it's time ic stop the bop. A Imjp will be stopped when rj NEXT is found 
which has its counter value greater than the end value, 

EXAMPLES of NEXT Statement: 

10 FOR J -=1 TO 5: FOR K = 10 TO 20; FOR N - 5 TO -5 STEP -1 



20 NEXT N, K, J 



(Stopping Nested Loops) 



10 FOR L = 1 TO 100 
20 FOR M = 1 TO 10 
30 NEXT M 
400 NEXT L 



(Note how fh» iDops do NOT crow each 
other) 



TO FOR A - 1 TO 10 
20 FOR S = 1 TO 20 

30 NEXT 
40 NEXT 



(Notice that no variable nomes or 
needed) 



NOT 

TYPE; Logical Operator 
FORMAT: NOT < expression > 

Action: The NOT logical operator "complements" the value of each bit 
in tts single operand, producing on integer "twos-complement" result. In 
other words, the NOT is really saying, "H it isn't. . , ". When working 
with a floating-point number, the operands ore converted to integers 
and any fractions are lost. The NOT operator can also be used in a 
comparison to reverse rhe true/false value which was the result of a 
relationship test and therefore it will reverse the meaning of the corn 
parison. In the firs) example below, if ihe "twos-complement" of ' AA" h 
equal to "BB" and if "BB" is NOf equal to "CC" then the expression is 
true. 
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EXAMPLES of NOT Operator: 

ID IF NOT AA = BB AND NOT(BB ~ CCJ THEN ... 

NN% = NOT 96: PRINT NN% 
-97 



NOTE; T& "td rtw value of NOT use the expression X={— [X + 1J). (The two's conrple- 
ment of ary IriTeger is the bit compemenr pits one.) 



ON 

TYPE; Statement 

FORMAT: ON <variable> GOTO / GOSUB <line- 
number> [,<line»number>] .... 

Action: The ON statement b used to GOTO one of several given 'ine- 
numbers, depending upon the value of a variable. The value of the 
variables car range from zero through the number of lines given. If the 
value is a non-integer,, the fractional portion is left off. For example, if 
the variable value is 3, OK will GOTO the third line-number in the list. 

If the value of the variable is negative, the BASIC error message 
^ILLEGAL QUANTITY occurs. If the number is zero, or greater than the 
number of items in The list. The progrcm just "ignores" The statement and 
continues with the statement following the ON statement. 

ON is redly nn underused vnrienr of the IF. . .THEN. . . starement. 
Instead of using a whole lot of IF statements each o*" which aends the 
program To 1 specific line, 1 ON statement can replace a list of IF 
statements. When you look at the first example you should norce that 
the 1 ON statement replaces 4 IF. . .THEN, . . statements. 

EXAMPLES of ON Statement: 

ON -(A=7)-2*(A=3)- 3*(A<3)-4*(A>7)GOTO 400,900,1000,100 

ON X GOTO 100,130,180,220 
ON X+-3 GOSUB 9000,20,9000 
100 ON NUM GOTO 150, 300, 320, 3P0 
500 ON SUM / 2 + 1 GOSUB 50, 30, 20 
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OPEN 



TYPE: I/O Statement 

FORMAT: OPEN <fi]e-num>, [<device>] [,<address>j 
[,"<*ile-nome> [,<type>] [,<mode>n 



Action: This statement OPENs ci channel for input and/or output to a 
peripheral device. However, you may NOT need all those parts for 
every OPEN statement. Some OPEN statements require only 2 codes: 

1) LOGICAL FILE NUMBER 

2) DEVICE NUMBER 

The <flle-num> is the logical file number, which relctes the OPEN, 
CLOSE, CMD, GET*, INPUT*, and PRINT* statements to eocr other 
and associates Them with the ^ile-name anc the piece of equipment 
being used. The logical file number can range from 1 to 255 and you 
can assign it any number you want in thai runtje. 



NOTE: F'le rurtlberi over 126 were real y des gned for other vies so it's good practice 
1o use only n umbers below 127 "for file numbers. 



Each peripheral device (printer, disk drive, cassette) in the system has 
its own number which it answers to. The <dev>ce> nLmber Is used with 
OPEN to Specify on which device T he data fila axists. Peripherals like 
cassette decks, disk drives or printers also unswer tc several secondary 
addresses. Think cf these as codes which tell each device what opera- 
tion to perform. The device logical file number is used with every G£T#, 
INPUT*, ond PRINT*. 

If the <device> number is left out the computer will automatically 
assume That you want yojr in-ormarion to he sent to and received frsm 
the Datassette™, which is device number 1. The file-name ccn also be 
left out, but later an in your program, you cai NOT call ihe *1le by name 
if you have not already given it one. When you are storing files on cas- 
sette tape, the computer will assume that the secondury <uddress> is 
ze^o (0) if you omit the secondary address (a READ operation). 
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A secondary address value sf one (1) OPENS cassette rape files far 
writing. A secondary address value of two (2) causes an end -of -tape 
murker to be written when the file is later closed, The end-af-Tape 
marker prevents accidentally reading past rhe end of data which results 
in the BASIC errar message ?DEVICE NOT PRESENT. 

For disk files, the secondary addresses 2 thru 14 ore available tor 
data-files, but other numbers have special meanings in DOS t,ommtinds. 
You must use a secondary address when using your disk drive(s). (See 
your disk drive manual for DOS command details.) 

The <file-name> is c string ot 1 — 16 characters and is optioral tor 
cassette or p-inter files. If the file <type> is left ou1 the type of file will 
automatically default to the Program file unless the <made> s given. 
Sequential files are GPENed for reading <<node> = R unless you specify 
that files should be OPENed for writing <mode>=W is spenifiea. A file 
<type> can be used to OPEN on existing Re a five file. Use REL for 
<type> with Relative files. Relative and Sequential files are for disk 
only. 

If yo j try to access a file before ir is OPENed the BASIC error message 
?FILE NOT OPEN will occur. If yoj try to OPEN a file for reading which 
does not exist the BAS C erru^ niessuye ?FILE NOT FOUND will occli-. If 
a file is OPENed to diss for writing end the file-name elready exists, the 
DOS error message FILE EXISTS occurs. There is no check of this type 
available fo- tooe files, so be sure that the tape is properly positioned or 
you might accidentally write over sorre data that had previously seen 
SAVfcd. IF a file is OPENed that is already OPfcW, the BASIC error mes- 
sage FILE OPEN occurs. (See Printe- Manuel for further details.') 
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EXAMPLES of OPEN Statements: 

10 OPEN 2, 8, 4 "DrSK-OUTPUT, 
5EQ,W" 

10 OPEN 1, 1,2, "TAPE-WRITE" 

10 OPEN 50, 

10 OPEN 12, 3 

10 OPEN 130, 4 

10 OPEN 1,1,0, "NAME" 

10 OPEN 1,1,1, "NAME" 

10 OPEN 1,2,0, CHR$ (10) 

10 OPEN 1,4,0, "STRING" 

10 OPEN 1,4,7, "STRING" 

10 OPEN 1,5,7, "STRING" 

10 OPEN 1,8,15, "COMMAND" 



(Opens sequential file on disk) 

{Write End-of-file an Close) 

(Keyboard input) 

(Screen output) 

(Printer output) 

(Read from cassetie) 

(Write to cassette) 

(Open channel to RS-232 device) 

(Send upper cuse'grupliks to 

tfio printer) 

(Send upper/lower case to 

printer) 

(Send Lppper^lower case to 

printer with device # 5) 

(Send ci command la disk) 
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OR 



TYPE: Logical Operator 

FORMAT: <operand> OK ^operand- 



Action: j us t as fhe relationa. operators can be used ro make decisions 
cgarding prog'-arr flow, logical operators can connect two or more re- 
atirirs and return a true or false value which can then be used in □ 
decision. When used in calculations, the logical OR gives you a bit result 
of 1 If the corresponding bit of either or both operands Is 1. This will 
produce on integer as a r esult depending on the values of the operands. 
When used in comparisons the logical OR operator is aiso used to link 
two express ons into a single compound expression. H either of the ex- 
pressions ore true, the combined expression value is true ( — 1). In the 
first example below if AA is equal to BB OR it XX is 20, the expression is 
true, 

Logical operators work by converting their operands to 16-bit, signed, 
two's complement integers in the range of —32768 to +32767, If the 
operands ore not in the range an error meswge results, hfich hit of the 
result is determined by the corresponding bits "n the two operands 



EXAMPIES of OR Operator: 

100 If {AA - BB) OR (XX - 20) THEN .... 

230 KK% = 64 OR 32: PRINT KK% (You typed this with a bit 

value of 1000000 for 64 

and 100000 For 32) 



96 



(The computer responded 
with bit value 1 100000, 
1100000=96.) 



6S 
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PEEK 

TYPE: Integer Function 
FORMAT: PEEK (<numerie>) 

Action: Returns an integer in the range af to 255, which is reod 
from c memory location. The <numeric> expression is a memory loca- 
tion which must be in the range of to 65535. If it isn't then the BASIC 
error message ? ILLEGAL QUANTITY occur*. 

EXAMPLES of PEEK Function: 

10 PRINT PEEK(53260)ANL> 15 [Returns value of screen 

border color) 
5 A% = PEEK<45) + PEEK(46)*256 (Returns address of BASIC 

variable table) 

POKE 

TYPE; Statement 

FORMAT: POKE <localien>, <value> 

Action: Th« POKE statement is used to write a one-byte (8 bits) binary 
value into a given memory location or input/c-jtput register. The 
<ln<-ation> is an arithmetic expression which must equal a value ir the 
range of to 65535. The <value> is an expression which ccn be re- 
duced to an integer value of to 255. If either value is out ot its respec- 
tive range, th e BASIC error message ? ILLEGAL QUANTITY occurs. 

The POKE statement and PEEK starernenT (which is o hiiilr-in ^unction 
that looks at a memory locoton) are useful for data storage, controlling 
graphics displays or sound generation, loading assembly langjage sub- 
routines, and pass no, arguments and results to and from assembly lan- 
guage subroutines. In addition, Cpercting Syslern parameters can be 
examined using PEEK statemenrs or changed and manipulated using 
POKE statements. A complete memory map of useful logulions is given 
in Appendix G. 
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EXAMPLES of POKE Statement; 

POKE T024, 1 (Puts an "A" at position 1 on ihe screen) 

POKE 2040, PTR (Updotei Sprtte #0 data pointer) 

10 POKE RED, 32 
20 POKE 3687°, 8 
2050 POKE A, B 



POS 

TYPE: Integer Function 
FORMAT: POS «dummy>) 

Action: Tells you the cur-ervt cursor position which, oi course, is in the 
range of (leftmost character) though position 79 on an 80-character 
logical screen ine. Since -he Commodore 64 has a 4u-column screen, 
any position from 40 through 79 wil : refer To the second screen line. The 
dummy argument is ignored. 

EXAMPLE of POS Function: 

1000 IF POSfO) > 38 THEN PRINT CHRS<13) 



PRINT 

TYPE: Statement 

FORMAT: PRINT [<variable>] [ <,/;>< variable>] .... 

Action: The PRINT statement is normally used to write data items to 
the screen. However, the CMD statement may he used to re-direct that 
output to any other device in tne system. The <variabl«(s)> in the 
output-list are expressions of any type. If no output-list is present, a 
blank line is printed- The position of enr-h printed item is determined by 
the punctuation used to separate items in the output-fist, 

The punctuation characters that you con use o-e blanks, commas, or 
semicoons. The 80-eharaeter logical sc-een line is divided into 3 print 
zones of 10 spaces ecch. In the list of expressions, a comma causes the 
next value to be printed at the beginning, of the nexl iuiie, A semicolon 
causes the nexr value to be printed immediately following the previous 
value. However; there are two exceptions to this rule; 
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1) Numeric items are followed by on added space. 

2) Positive numbers have a space preceding them. 

When you use blcnks or no punctuation belween string constants or 
variable names it hns the same effect as a semicolon. However, blanks 
between c string and a numeric item or between two numeric items will 
stop output without printing the second item. 

If a comma or o semicolon is at the end of Ihe uul put-list, the next 
PRINT stafemen 4 begins printing on rhe same line, and spaced accord- 
ingly. If no punctuation finishes the list, a carriage-return arid u line- 
feed are printed at the end of the data. I he next PRINT statement will 
begin on the next Ine. If your output is directed to the screen and the 
data printed is longer than 40 columns, the output is continued on the 
next screen line. 

There is no statement in BASIC with mare variety than the PRINT 
statement. There arc so mony Gymbols, functions, one parameters 
associated with this statement tnat it m grit almost bp rnnsidered m n 
language of its own within BASIC; ct language specially designed for 
writing on the screen. 

EXAMPLES of PRINT Statement: 
1) 

5X = 5 

10 PRINT -5% X-5, X+5, X f 5 

-25 10 3125 

2) 

5 X=9 
10 PRINT X,"SQUARED IS";X*X ? "AND"; 
20 PRINT X "CUBED IS" X A 3 



9 SQUARED IS 81 AND 9 CUBED 15 729 



3) 



90 AA$="ALPHA' J :BB$="BAKER': CCS^'THARLIE'^DD^'-DOG": 

EE$="ECHO" 
100 PRINT AA$BB$;CCS DD$,EE$ 

ALPHABAKERCHARLIEDOG ECHO 
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Quote Mode 

Once the quote mark ( | QQ ) is typed, -he cursor controls stop 
operating and start displaying reversed characters which actually stand 

for the cursor conrrcl you are hitting. This allows you tq program those! 
cLrsor controls, because once the text inside the quotes is PRINTed they 
perform their functions. The IflflHlHB key is the only cursor cant'ol 
rot affected by "quote mode." 

1. Cursor Movement 

Tile cursor cunlrrjli wlich cun ye "p'otjiUrrimed" In quote mode ure: 

KEY APPEARS AS 

03 oees? n 



EMM [-SI^-hE 

If you wanted the word HELLO tc PRINT diagonally from ?he upper left 
corner of the screen, you would type; 

print " MNMtiUM h (jESB E BiliiiiUJ L llf&HLJ >- GdSlD °" 

wfiich would appear as: 

PRINT " O H Q E Q L Q L Q O" 
2, Reverse Characters 



Holding down the | | key on d hitting Q will cause | | to op- 
pear inside the quotes. This will nuke ull chumtters slarl printing in 
reverse video [like a negative of a picture). To end the reverse printing 
hit ISfll Q , which prints a f__J or else PRINT a Q3ZE3 (CHR£( 13)). 
(Just ending the PRINT statement withcLf n semicolon or comma will 
take core of this,) 

3. Color Controls 

Holding down thp J } Icey or | | key with any ot the 8 ca or keys 
will make a specicil reversed character appear in the quctes. When the 
character is PRINTed, then the color change will occur, 
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KEY 



□ 

Q 

H 
H 
□ 
E3 

H 



COLOR 


APPEARS AS 


Black 


■ 


While 


B 


Red 


B 


Cyan 


B 


Purple 


E 


Green 


D 


Blue 


B 


Yellow 


B 


Orange 


n 


Brown 


B 


Light Red 


63 


Grey 1 


B 


Grey 2 


□ 


Light Green 


■1 


Light Blue 


□ 


Grey 3 


■■ 
■■ 



If yuu wauled lu PRINT Ihe word HELLO (n cyan and the word THERE 
in white, -yper 



PRINT 



HELLO 



THERE' 



THERE" 



which would appear os: 

PRINT " ^ HELLO 
4. Insert Mode 



The spnr.es created by using the [ ; „ ] key hove snme af the some 
characteristics as quote mooe- The cursor controls and color controls 
show up cs reversed characters. The only d ffe^ence is in the (. jand 
, which performs its normal function even in quote mode, now 
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creates the Q . And | | , which created a special character in 
qjote mode, irserts ssoces norinal'y. 

Becuuse of this, ir is possible to create a PRINT statement containing 
DELetes, which cannot be PRINTed in quote mode. Here is or excmple 
of huw ihis is done: 



10 PRINT"HELLO' 
P" 



INST/DEL I SHIFT I INS1/DEL I SHIFT 1 INST/DEL I INST/DEL 



which displays as 

10 PR I NT" HELLO 

When the above line is RUSI, -he word displayed will be HELP, be- 
cause the last two letters are deleted and the P is put in their plnre. 



WARNING: The DELetes will work when listing as well as PRINTing, 53 editing o 
liie with -hese characters wll be dtfficulr. 



The "insert mode" condhion is ended when the 

for ijLjUJJ ^:l^»l:l f 'fc :■ key is ( iit, or when as many characters have 
been typed as spaces were inserted, 

5. Other Special Characters 

There are some other characters that can be PRINTed -or special 
functions, although they are not easily available from the keyboard, 'n 
order to get these into quotes, you must leave empty spaces i or them in 
the line, h't f?l^lll:l!l or EJJ3 MWMM , and go back to the 

spaces wirh the cursor controls. Now you must hit j | , 

to start typing reversed characters, and type the keys shown below: 

Function Type Appears As 

iriai B3B3Z1 EHE1 Q 101 

twitch to lower case Q 

switch to upper case B20 D 

disable case switching keys 

enable case-switching keys 
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The gjgj i will work in this LISTing as well as PRIMT- 

irg, so editing will be almusl impossible il I his cliuruc _ er is used. The 
[Idling '/will also, look very strange. 



PRINT# 

TYPE: I/O Statement 

FORMAT: PRINT#<file-numbef> [<variable>] 
[<,/ ; ><variable>] .... 

Actions: The PRIMT# statement is used to write data items to a logical 
file. Ir must use the same number used to OPEN The file. Output gees to 
the device-number used in the OPEN statement. The ^variable^* ex- 
pressions in The output-list can be of any type. The punctuation char- 
acters between items are the same as with the PRINT statement and 
they can be used in the same ways. The effects of punctuation are 
different in two significant respects, 

When PRINT# Is used with tape files, the comma, instead of spacing 
by print zones, has the same effect as a semicolon. Therefore, whether 
blanks, commas, semicolons or no punctuation characters are used be- 
tween data items, the effect on spacing is the same. The data items are 
written as a continuous stream of characters, Numeric items are fol- 
lowed by a space and, if positive, ore preceded by a space. 

If no punctuation finishes the list, a carriage-return and a line-feed 
are written at the end nf the datn. If a rnmmn nr semirnlnn terminates 
the output-list, the carriage-return and line-feed are suppressed. Re- 
gardless of the punctuation, the next PRINT# statement begins output in 
the next available character position. The line-teGd will act as a stgp 
when using the INPUT# statement, leaving an empty variable when the 
next INPLfT# is executed. The fine-feed can be supp'esied or compen- 
sated for os shown in the examples below. 

The easiest way to write more than one variable to a tile on tape or 
disk is rc set o siring variable to CHR$(13), and use that string in be- 
tween all the other variables when writing the file. 
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EXAMPLES ef PR1NT# Statement: 

10 OPEN 1,1,1, "TAPE FILE" 

20 R$ = CHR$<13) 

30 PRINT# 1,1;R$;2;R$;3;»$;4;R$;5 

40 PRINT# 1,6 

50 PRINT* 1,7 



(By Charging the CHR${13) to 
CHR$[44) you put a "," hetween 
each variable. CHR$(59) would 
put a "•'' between each 
variable.) 



2) 



10 CO$ = CHR$(44) : CR$=CHR$(73} 

20 PRiNT#l, "AAA"CO$"BBB", AAA,BBB CCCDDDEEE 

"CCC";"DDD";"EEE"'CR$ [carriage return) 

"FFF"CR$; FFF(carriaae return] 

30 INPUT#1, A$,BCDE$,F$ 



3) 



5 CRS = CHR$(13) 
10 PRJNT#2, "AAA",-CR$;"BBB" 
20 PRINT#2, "CCC"; 

30 INPUT#2, A$,B$,DLJMMY$,C$ 



(TO blanks) AAA 
EBB 

(10 banks)CCC 



READ 

TYPE; Statement 
FORMAT: READ <variable: 



[,<vnriahle>] . 



Action- The READ statement is used to fill variable names from con- 
stants in DATA statements. The data actually read must agree with the 
variable types specified or the BASIC error message ?SYNTAX ERROR 
will result. Variables in the DATA input-list must be separated oy com- 
mas. 

A single READ statement can access one or more DATA statements, 
which will be accessed in order (see DATA), or severul READ statements 
can access the same DATA statement. It more READ statements ere exe- 
cuted than the number of elements in DATA s'atenienls(s) in the pro- 
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gram, the BASIC error message ?OUT OF DATA is printed, If the 
number af variables specified is fewer than the number of e'ements in 
the DATA statement(s), subsequent READ statements will continue read- 
ing ai the next data element. (See RFSTOHt.) 



*NOTE: The 7SYMTAX ERROR will appeor with the line number from the DATA state- 
ment. NOT ihe READ statement. 



EXAMPLES af READ Statement: 

110 READ A,B,CJ 
120 DATA 1..2.HELLO 



100 FOR X=l TO 10: READ A(X>:NEXT 

200 DATA 3. 0B, 5.19, 3,12, 3,?6, 4.24 
210 DATA 5. OB, 5.55, 4,00, 3.16, 3.37 

(Fills array items (line 1} in order of constants shown (line 5)) 

1 RtAD CITrfc,STATE$,ZIP 

5 DATA DENVER, COLORADO, 80211 



REM 

TYPE: Statement 
FORMAT: REM |<remark>l 

Action: The REM statement makes your programs more easily under- 
stood when LISTed. It's a reminder to yourself ro rell you wharyou had in 
mind when you wore writing each section of the program, For instance, 
you might want to remember what a variable Is used tor, cr some other 
useful information. The REMark can be any text, word, or character 
including the colon fs) or BASIC keywords. 

The REM statement and anylhing following it on tne same line-number 
are ignored by BASIC, bui REAAarks are printed exactly as entered when 

the program is listed. A REM state Tien t can be referred to by a GOTO or 
GOSUB statement, and the execution of the program will continue with 
the nex* higher program line having executable statements, 
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EXAMPLES of REM Statement: 

10 REM CALCULATE AVERAGE VELOCITY 

20 FOR X=l TO 20 ;REM LOOP FOR TWENTY VALUES 

30 SUM = $UM + VEL(X): NEXT 

40 AVG=SUM/20 



RESTORE 

TYPE: Statement 
FORMAT: RESTORE 



Action: BASIC maintains an internal pointer to the next DATA constant 
to be READ. This pointer con be reset to the first DATA constant in a 
program jiing the RESTORE statement. The RESTORE statement car be 
used anywhere in the program to begin re-READing DATA. 

EXAMPLES ef RESTORE Statement: 

100 FORX^l TO 10: READ A[X): NEXT 

200 RESTORE 

300 FOR Y=l TO 10: READ B(Y): NEXT 

4000 DATA 3.08, 5.19, 3.12, 3.98, 4.24 
4100 DATA 5.08, 5.55, 4.00, 3.16, 3.37 



(Fills the two arrays with identical data) 

10 DATA 1,2,3,4 
20 DATA 5,6,7,8 
30 FOR L-l TO 8 
40 READ A: PRrNT A 
50 NEXT 
60 RESTORE 
70 FOR t-J TO 8 
80 READ A: PRINT A 
90 NEXT 
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RETURN 

TYPE: Statement 
FORMAT: RETURN 

Action: The RETURN statement is used to exit from a subroutine called 
for by a. GOSUE statement, RETURN restarts the rest of your program af 
the nexr executable statement following the GQSUB. If you are nesting 
subroutines, each GQSUB must be paired with at least one RETURN 
statement. A subroutine can contain any number of RETURN statements, 
but the first one encountered will exit the subroutine. 

EXAMPLE of RETURN Statement: 

10 PRINT "THIS IS THE PROGRAM" 

20 GOSUE 1000 

30 PRINT "PROGRAM CONTINUES" 

40 GOSUB 1000 

50 PRINT "MORE PROGRAM" 

60 END 

1000 PRINT "THIS IS THE GOSUB":RETURN 



RIGHT$ 

TYPE; String Function 

FORMAT: R1GHT$ (<string>, <numerk>) 

Action: The RIGHT! function returns a sub-string taken from the right- 
most end of the <string> argument. The length of the sub-string is 
defined by the <numertc> argument which can be any intege' in the 
range of to 255. If the value of the numeric expression : s sc-ro, then a 
null string ("") is returned. If the value you give in the <numerlc> 
argument is greater thar the length of the <string> then The entire 
string is returned. 

EXAMPLE of RIGHTS Function: 

10MSGJ = "COMMODORE COMPUTERS" 

20 PRINT RFGHT$<M5G$,9) 

RUN 

COMPUTERS 
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RND 



TYPE: Floating-Point Function 
FORMAT: RND (<numerie>> 



Action: RND creates a floating-point condom from 0.0 la 1.0. The 
compuler generates a sequence of rcjndom numbers by performing cal- 
culations on a starting number, which in computer jargon is called a 
seed. The RND function is seeded an sysleni power-up. The 'Oiumeric^' 
argument is a aumnny, except for its sign (positive, zero, or negative). 

If the <nurneric> argument is positive, the same "pseudorandom" 
sequence of numbers is retjrned, starting from a given seed value. Dif- 
ferent rumber sequences will result from different seeds, but any se- 
quence is repeatable by Storting f'orn the same seed number. Having a 
known sequence of "random" numbers is useful in testing programs. 

If you choose a <numeric> argument of jero, then RND gene-ates a 
number directly frcrn a free-running hardwart clack (the system "jiffy 
clock"). Negative arguments cause The RND 'unction to be re-seeded 
with each function call. 

EXAMPLES of RND Function: 



220 PRINT INTtRNDtCrSO) 



(Return random integers 

0-4?) 



100 X = INT(RNDCiy*6>+INT(RNDn)*6H-2 {Simulates 2 dice) 



100 X=lNTtRND(I)' : 1000) + l 



(Random integers from 

1-1000) 



100 X = INT(RND(ir 1505 + 100 



(Random numbers from 
100-249) 



100 X = RND[1)*(U-L)+L 



(Random numbers between 
upper (U) and Icwer 
(L) limits) 
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RUN 

TYPE: Command 

FORMAT: RUN P line-number ] 

Action; The system command RUN is used to start the program cur- 
rently in memory. The SUN command causes an implied CLR operation 
to be performed before starting the program. You can ovoid the CleaR- 
ing operation by using CONT nr GOTO to restart a program instead of 
RUN. If a <ine-nurrber> is specified, your program will start on that 
line. Otherwise, the RUN command starts at first line of rhe program. 
The RUN command can also be used within a program. If the <line- 
number> you specify doesn't exist, the BASIC error message UNDEF'D 
STATEMENT occurs. 

A RUNning program stops and BASIC returns to direct made when an 
END or STOP statement is reached, when the last line of the program is 
finished, or when a BASIC error occurs during execution. 

EXAMPLES of RUN Command: 

RUN (Starts at first line »f progrom) 

RUN 500 (Starts at line-number 500) 

RUN X (Starts at line X, or UNDEF'D STATEMENT ERROR 

if there is no line X} 



SAVE 

TYPE: Command 

FORMAT: SAVE ["<flle-n«me>"] [^device- number>] 
l,<address>] 

Action: The $Vft/E command is used to store the program that is cur- 
rently in memory onto a rape or diskette file. The program being 5/ti/Ed 
is only affected by the command while the S/WE i& happening. The pro 
gram remains in the cur^em computer memory even after the SAVE op- 
eration is completed until you put something else 'here by using another 
command. The file type will be "prg" Cprograrr). H the <device- 
number> is left out, then the C64 will automatically assume that you 
wrjnt the program saved on cassette, device number 1 If the <devire- 
number> is <tri <8>, then the prog'am is written onto disk. The SAVE 
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statement con be used in your programs and execution will continue 
with the next statement o*ter the SAVE is completed. 

Programs on tape ere automatically stored twice, so that your Com- 
modore 64 con check for errors svhe-n LQADirig the program bock in. 
When saving programs to tape, the <fiie-name> and secondary <ad- 
dre?s> are optional. But 'allowing a SAVE: uvith a program name in 
quotes (" ") or by a String varable (— $) helps your Commodore 64 find 
each program more easily If the fife-name is left out it can NOT be 
LOADed by name later on. 

A secondary address of 1 wili tell the KFRNAL to LOAD the tripe ot a 
later time, with the program currently in memory instead of the normal 
2048 location, A secondary address of 2 will cause nr end-of-tnpe 
marker to Follow the program, A secondary address of 3 combines both 
functions. 

When saving programs onto a disk, the <f!lc-rtame>- must be pre- 
sent. 

EXAMPLES of SAVE Command; 



SAVE 

SAVE "ALPHA", ! 

SAVE "ALPHA", 1, 2 
SAVE "FUN. DISK", 8 
SAVE A$ 
10 SAVE "HI" 

SAVE "ME",1,3 



(W-ite to tape without a name) 
(Store on tape as file-name "alpha") 
(Store "alpha" with end-of-tapo marker) 

(SAVES on disk (device S it the disk)) 

(Store on tape with the name A$) 

{SWEs program and then move to next 
program line) 

(Stores at same memory location and 
puts an end-af-tope marker on} 
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SGN 

TYPE: Integer Function 
FORMAT: SGN (<numerk>) 

Action: SGN gives you an integer value depending upon the sign of 
the <numeric> argument. H the argument is positive the result is 1 , If 
zero the result is also 0, if negar've the result is —1. 

EXAMPLE of SGN Function: 

90 OM SGN(DV)+2 GOTO 1 00, 200, 300 

(jump to 100 if DV- negative, 200 if DV = 0, 300 if DV= positive) 



SIN 

TYPE: Floating-Point Function 
FORMAT; SIN (<numeric>) 

Action: SIN gives you llie sine of the <numerk> argument, in ra- 
dians, The value of COB[x) is equal to 5IN(x + 3.14159265/2J, 

EXAMPLE of SIN Function: 

235 AA - SIN(1,5): PRINT AA 
.997494937 



SPC 

TYPE: Special Function 
FORMAT; SPC (<numerie>) 

Action: The SPC function is used to control the formatting of data, as 
either an output to lhe screen or nto a logical file. The number uf 
SPaCes given by the <numeric> argument are printed, starting at the 
first available position. For screen or tape files the value of the argument 
is in the range of to 255 and for disk files up to 254. For printer files, 
an automatic carriage-relum and line-reed wifl :jb performed by tlie 
printer if a SPaCe is printed in the last character position of a line. No 
SPaCes are printed on the following line. 
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EXAMPLE of SPC Function: 

10 PRINT "RIGHT "; "HERE &"; 

20 PRINT SPC(5> "OVER" SPC(U) "THERE'' 

RUN 

RIGHT HERE S. OVER THERE 



SQR 

TYPE: Flooting-Point Function 
FORMAT: SQR (<numeric>) 

Action: SQR gives you The voue of the SQuare Root cf The 

■=^ numeric^* argument. The vclue of the argument must not be negative, 

ur the BASIC error message ? ILLEGAL QUANTITY will happen. 

EXAMPLE of SQR Function: 

FOR J = 1 TO 5: PRINT J + 5, SQR(J * 5): NEXT 

10 3.16227766 

15 3.B7208335 

20 4.47213595 

25 5 



__ 






READY 



STATUS 

TYPE: Integer Function 
FORMAT; STATUS 

Action: Returns a completer STATUS for the last input/output opera 
tion which wflS performed on an open file. Trie STATUS can be read 
from any peripheral device. Trie STATUS (or simply ST) keyword is a 
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system defined variable-name into which the KERNAL purs the STATUS of 
I/O operations. A tabJe of STATUS code venues for tape, printer, dis« 
and RS-232 file operations is shown below: 



5T Bit 
Position 


ST Numeric 
Value 


Cassette 
Read 


Serial 
Bus R/W 


Tape Verify 
+ Load 





1 




rime out 
write 




1 


2 




fiTie out 

read 




7 


4 


short h ock 




short block 


3 


8 


long block 




long block 


4 


16 


unrecoverable 
read -error 




any misna+cri 


5 


32 


checksum 
error 




checksum 
error 


6 


64 


end of file 


EOI 




7 


-12S 


end of tape 


device not end of tope 
present 



EXAMPLES of STATUS Function: 

10 OPEN I, 4: OPEN 2, S r 4, "MASTER FILE,SEQ,W" 

20 GOSUB 100: REM CHECK STATUS 

30 INPUT#2, A$, B, C 

40 IF STATUS AND 64 THEN SO, REM HANDLE END-OF-FILE 

50 GOSUB 100: REM CHECK STATUS 

60 PRINT#1, A$, B; C 

70 GOTO 20 

80 CLOSE1: CLOSE2 

90 GOSUB 10C : END 

TOO IF ST > THEN 9000: REM HANDLE FILE I/O ERROR 

110 RETURN 
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ss 



STEP 

TYPE: Statement 

FORMAT: TSTEP <expression>] 

Action: Ths optional SIEP keyword follows the <end-value> exprss 
sion in a FOR statement. >t defines on increment value for the loop 
counter varicihle. Any vnlue cnn he used as the STEP increment. Of 
course, a STEP value of zero wi I loop forever. If the STEP keywcrd is lef~ 
out, the increment value wil 1 be + ) . When the NEX I statement in a FOR 
Icop is reached, the STEP increment hapoens. Then the counter is tested 
against The erd-value to see if The loop is finished (See FOR stntemen- 
*or more information. J 



NOTE? The STEP valu« can NOT bs cScmgec 1 one* If* to the loop 



EXAMPLES of STEP Statement: 

25 FOR XX = 2 TO 20 STEP 2 (Loop repeats 10 times) 

35 FOR ZZ = TO -20 STtP -2 (Loop repeats II times) 

STOP 

TYPE: Statement 
FORMAT: STOP 

Action: The STOP statement is used to halt execution of the current 
program and return to direct mode. Typing the key on the 

keyboard has the same effect as a STOP sioTement. The BASIC error 
message ?BREAK \H LINE nnnnn is displayed on the screen, followed 
hy READY. The "rnnnn" is the line-number where the STOP occurs. Any 
open "rlea remain- open and all var ables are areserved and can be 
examined. The program can be restarted by using CONT or GOTO 
statements. 

EXAMPLES of STOP Statement: 

10 INPUTS 1, AA, BB, CC 

20 IF AA = BB AND BB = CC THEN STOP 

30 STOP 

Of the variable AA is —1 and BB is equal to CC then:) 

BREAK IN LINE 20 

BREAK IN LINE 30 (For any other data values) 
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STR$ 

TYPE: String Function 
FORMAT: STR$ {<nwmeric>) 

Action: STR$ gives you the STRing representation of the numeric value 
of the argument. When the SIRS value i£ converted to each variable 
represented in the <numerfc> argument, any number shown is fol- 
lowed by a space and, if it's positive, it is also preceded by a spacs. 

EXAMPLE of STR$ Function; 

100 FIT = 1.5E4: ALPHA$ - STR$(FLT) 
1 10 PRINT FIT, ALPHAS 

13000 13000 



SYS 

TYPE: Statement 

FORMAT: SYS <memory-lo*ation> 

Action: jhis is the most common way to mix a BASIC program with a 
machine language program. The machine language program begins a: 
the location giver In the SYS statement. The system command SYS is 
used in either direct or program mode to transfe' control of the micro- 
processor 1o on existing machine language program in memory. The 
mernory-locaiion given is by numeric expression and can be anywhere in 
memory, RAM o^ ROM. 

When you're using the SYS statement you must end that section of 
machine languoge code with on RTS (ReTurn from Subroutine) instruction. 
so that when the machine lunguuge program is finished, the BASIC 
execution will resume with the statement following the SYS command. 

EXAMPLES of $*S Statement: 

SYS 64738 tJurnp to System Cold Start in ROM) 

10 POKE 440C,?6: SYS 4400 (Goes to machine code location 4400 

and returns immediately) 
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TAB 

TYPE: Special Function 
FORMAT: TAB (<numeric>) 

Action: The TAB function moves the cursor to a rela+ive SPC move 
posit'on on the screen given by *he <rturneric> argument, starting with 
The left-most position of the current line. The value of the argument can 
range from to 255, The TAB furcrion should Dnly be used with the 
PRINT statement, since it has no effect if used with PRINT# to a logical 
fie. 

EXAMPLE of TAB Function: 

100 PRINT "NAME" TAB(25) "AMOUNT': PRINT 
110 INPUT#1, NAM$, AMT$ 
120 PRINT NAM$ TAB(25) AMT? 

NAME AMOUNT 

G.T. JONES 25. 



TAN 

TYPE: Floating-Point Function 
FORMAT: TAN (<numeric>) 

Action: Returns the tangent of tine value of the <numeric> expression 
in rndians. If the TAN function overflows, the 3A5IC error message ?DI- 
VISION BY ZERO is displayed. 

EXAMPLE of TAN Function: 

10 XX = .785398 1c3r YY = TAN(XX): PRINT YY 

1 
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TIME 

TYPE: Numeric Function 
FORMAT: Tl 

Action The Tl function reads Irie interval Timer. This type of "clock" ts 
called a "jiffy clock." The "jiffy clock" value is set at zero (initialized) 
when you power-up the system. This l/&0 second inlervul timer J s Turned 
off during tape I/O. 

EXAMPLE of Tl Function: 

10 PRINT TI/60 "SECONDS SINCE POWER UP" 



TIMES 



TYPE: String Function 
FORMAT; Tl$ 



Action: The Tl$ timer look* and works like a rtul duck as long us your 
system H powe r ed-on. The hardware interval timer (or jiffy clock) is read 
and used to update the value oF Tl$ r which will give you a Time $tring of 
six characters in hours, rrinute-i cind seconds. The TIS timer can alio be 
assigned an arbitrary starting point similar to the way you set your 
wrisrjvateh. The value of TIS is not accurate after Tape I/O. 

EXAMPLE of Tl$ Function: 

1 TIS <= "000000": FOR J = ] TO 1000G: NEXT: PRINT Tl$ 

000011 
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USR 

TYPE: Floating-Point Function 
FORMAT: USR (<numerk>) 

Action: The USR function jumps to a User callable machine language 
SubRoutine which has its starting address pointed to by "he contents of 
memory iprntiriris 785—786. The starting address i; established before 
calling the USR function by using POKE statements to set up locations 
785-786. Unless POKE statement;; are used, Incntinns 785-786 will give 
you an ? ILLEGAL QUANTITY error message. 

The value of the <numeric> argument is stared in the floating-point 
accumulator starting at loea-ion 97, for access, by the Assembler code, 
and rhe resu t of the USR function ts The va ue which ends up there when 
the subroutine returns to BASIC, 

EXAMPLES of USR Function: 

10 B - T * SIN(Y) 
20 C = USR (1/3) 

30 D - USR (6/3) 

VAL 

TYPE: Numeric Function 
FORMAT: VAL (<string>) 

Action; ReTurns a numeric VALue representing the data in the 
<string> argument. If the first non-blank character of the string is not a 
plus sign (+). minus sign ( — ), or a digiT rhe VALue returned is zero. 
String conversion Is finished wher the end of the string or any non digit 
character is found (except decimal point or exponential e). 

EXAMPLE of VAL Function: 

10 INPUT#1, NAM*, ZIP$ 

20 IF \ftL(ZIPJ) < 19400 OR VAL(ZIP$) > 96699 

THEN PRINT NAM$ TA&(25) "GREATER PHILADELPHIA" 
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VERIFY 



TYPE: Command 

FORMAT: VERIFY r<file-name>"] [,<device>] 



Action: The VERIFY command is used, in direct or program mode, to 
compare the contents of a BASfC program file on tape or disk with rhe 
program currently in memory. VERIFY is normally used right after a 
SAVE, to make sure that the p _ og r am was stored correctly on tape 0' 
disk, 

[f the <de/ice> number is left out, rhe p'ograrn Is assumed to be on 
the Dotosscttc"*" which Is device number 1. For tape files, if the <file- 
name> is left out, the ie*t program found on the tape will be com- 
pared, For disk files (device number 8), the fle-name must be present. If 
any differ em.es> in program text are found, the BASC error message 
7VERIFY ERROR is displayed 

A p-ogram name can be given eithe' in quotes (" ") or as a string 
variable. VERIFY is also used to position □ tape just oeisr the last pro- 
gram, so that a new program can be added to the tape without acci- 
dentally writing over another program. 



EXAMPLES of VERIFY Command: 

VERIFY (Checks 1st program on tape) 

PRESS PLAY ON TAPE 

OK 

SEARCHING 

FOUND <FILENAME> 

VERIFYING 

9000 SAVE "ME",8: 

9010 VERIFY "ME",$ (look at device S tor the program) 
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WAIT 

TYPE: Statement 

FORMAT: WAIT <lacntion>, <masli-l> [,<mask-2>] 

Action: The WAIT statement causes program execution to be sus- 
pended unlit a given memory address recognizes a specified bit pattern. 
In Other words VlftIT can be used to halt the program until some external 
event has occurred. This is done by monitoring the status of bits in the 
input/output registers. The data items used with VWIT can be any 
numeric expressions, but they will be Converted to integer values. 

For most programmers, this staTennent should never be used. It causes 
the program to halt until a specific memory locator's bits chongc in a 
Specific way. This is used for certain I/O operations and almost nothing 
else. 

The WAIT statement takes the value in the memory locar'on and per- 
forms a logical AND operation with the value in rnask-1 , If there Is a 
mask-2 in the statement, the result of the first opercrtiun is exclusive- 
ORed with mask-2. In other words mask-] "fllte's out" any bits that you 
don't want to test. Where the bit is in mosk-1 , the corresponding bit irv 
the result will always he 0, The mask-2 value flips any bits, so that you 
ccn test for an off condition as well as an an condition. Any bits being 
tested for a should have a 1 in the corresponding position in mask-2. 

If corresponding bits of the < mask ]>ond <mask-2> operands differ, 
The e>clusive-OR opera-ion gives a bit result of 1 . If corresponding bits gel 
the same result the bit is 0. It is possible to enter an infinite pause with the 
WAIT sta-ement, in which case the HSffT H? und 1-J55KC1 keys 
can be used to recover. Hold down the tiliJIM.'tMd key and then 
press ■■■".J . The first example below WAITs until a key is pressed on 

the tape unit to continue v/ith tie program. The second example will WAIT 
until a sprite collides v/ith the screen background, 

EXAMPLES of WAIT Statement. 

WAIT 1, 32, 32 

WAIT 53273, 6, 6 

WAIT 36868, 144, 16 (144 & 16 are masks. 144^10010000 Id 

binary and 16=10000 in binary. The 
WAIT statement will halt the pro- 
gram until the 128 bit is on or 
until the 16 bit is off) 
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THE COMMODORE 64 KEYBOARD 
AND FEATURES 

The Operating System has a ten-character keyboard "buffer" Thai is 
Lsed to hold incoming keystrokes until the/ can be processed. This buf- 
fer, or queue, holds keystrokes in the order in which they occur so that 
the first one put into the queue h the first one processed. For example, if 
a second keystroke occurs before the first can be processed, the secund 
character is Stored in the butter, while processing of the first character 
continues. After the program has finished with the Hist character, the 
keyboard buffer is examined for more data, aTd the second keystroke 
processed. Without this buffer, rapid keyboard input would occasionally 
nrop chnrcicters. 

In other words, the keyboard buffer allows you to "type-ahead" of 
the system, whlcn means it can anticipate responses tn INPUT prnmp^s 
or GET statements. As you type on the keys their charac*er values are 
lined up, single-file (queued) into the suffer to wait for processing in the 
order the keys were struck. This type-ahead feature con give you an 
occasional problem where an accidental keystroke causes a program to 
fetch on incorrect character from the buffer, 

Normally, incorrect keystrokes present no problem, since they can be 
cor-octcd by the CuRSoR Lett 35^H or DELete ||^^f keys 
and then retyping the character, and the corrections will be processed 
before o following carriage-return. However, if you press the | ; ■■ 
key, no corrective action is possible, since all characters in ihe buffer up 
to and including the carriage-return will be p-Qcessec before any cor- 
rections. This situation can be avoided by using a locp to empty the 
keyboard buffer before reading an intended response: 

10 GET JUNICt: IF JUNKS <>"" THEN 10: REM EMPTY THE 
KEYBOARD BUFFER 

In addition to GET and INPUT, the keyboard can also be reed using 
PFEK to fetch from memory location 197 ($0OC5) ihe mlecjer value of the 
key currently being pressed, If no key is being held when the PFfct is 
executed, a value of 64 is returned. The numeric keyboard values, 
keyboard symbols and character equivalents (CHR$) are shown in Ap- 
pendix C. The following enumpe loop> until o key is pressed then con- 
verts the integer to a character value. 

ID AA = PEEKT.197), IF AA s= 64 THEN 10 
20 BB$ = CHR${AA) 
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The keyboard is treated as a set of switches organized into a matrix 
of S coluirns by 8 rows. The keyboard matrix is scanned for key 
switch-dosums by the KERNAL using the CIA #1 I/O chip (MOS 6526 
Complex Interface Adopter), Two CIA registers are used to perform the 
scan: register #0 at locaticr 56320 (SDCOC) for Keyboard columns and 
regisler #1 ut location 56321 (SDC01) for keyboard rows. 

Bits 0—7 of memory location 56320 correspond ro the columns 0-7. 
Bits 0-7 of memory location 56321 correspond to rows 0-7, By writing 
column values in sequertco, then reading row vaiues, the KERNAL de- 
codes The switch closures into the CHR$ (M) value of the key pressed. 

Eight columns by eight rows yields &4 possible values. However, if yoj 
first strike llie I J3 , ^^Q or ^g keys or hold dow'i 
the E33 ^ey r,nc ' tyP e a second character, additional values are 
generated. This is because the KERNAL decodes T hese keys separately 
and "remembers" when one of the control keys was. pressed. The result 
of the keyboard scan is men placed in location 197. 

Charcctc-rs can also be written directly to the keyboard buffer at lo- 
cations 631-640 using a POKE jtotement. These characters will be 
processed when the POKE is used to se1 a character count into location 
198. These facts can be used to cause a series of direct- mode com- 
mands to be executed automatically by printing the statements onto the 
screen, putting corriage- returns into the buffer, and then setting the 
character count. In the example below, the program will LIST Itself ro 
the printer and then resume execution, 

10 PRINT CHR$047)"PRINT#1; CLOSE 1: GOTO 50" 

20 POKE 631,19= POKE 632,13= POKE 633,13: POKE 198,3 

30 OPEN 1,4: CMD1: LIST 

40 END 

SO REM PROGRAM RE-STARTS HERE 



SCREEN EDITOR 

The SCREEN EDITOR provide* yoj with powerful and convenient 
facilities for editing program text. Once a section of a pra^mm is listed 
to the screen, the cursor keys and other Special keys are used to move 
around the screen so that you can make any appropriate changes. After 
making all the changes you want to a specific iine-number of text, hit- 
tine; the ^ v key anywhere on the line, causes the SCREEN 
EDITOR to read the entire SO-character logical screen line, 
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The text is then passed to the Interpreter tc oe token ized and stored in 
the prog'anr. The edited line replaces the old version at that line in 
memory. An uddil'onol topy of any lire of lex* can Lie creoted simply by 
changing the line-number and pressing | I 

IF yoL use keyword abbreviations which cause a program line to ex- 
ceed 80 characters, the excess characters will be lost when that line is 
edited, betuust: the EDITOR will reud only two physical screen lines. This 
is also why using INPUT tor more than a total ot 80 characters is not 
possible. Thus, for all practical purposes, llie leriyth uf u line of BASIC 
text is limited *o 60 characters as displayed on fhe screen. 

Under certain conditions the SCREEN EDITOR treats the cursor conrro/ 
keys differently from their normal mode of handling. It the GuRSqR is 
positioned to the tight of un odd number of double-quote murks (") the 
EDITOR operates in what is known as the QUOTE-MODE. 

In ujuo'e made cata characters are entered normally but the cursor 
controls no longer move the CuRSoR, instead reversed characters are 
deployed which actually stand for the cursor control beincj entered. The 
same is true of the color control keys. This allows you to include cursor 
and color controls inside string data items r n program-. You will find that 
this is a very important and powerful feature That's because when the 
text inside the quotes is printed to the screen it performs the cursor 
positioning and colo* control functions automatically as part of the 
string. An example of using cursor controls In st-ings is: 



You type -* 10 PRINT "A[RXRJBa)(L)lL)C(R)(R)D":REM{R)=CRSR 

RIGHT, [L)=CRSR LEFT 



Computer prints - *■ AC BD 



The | ■■ i key is the only cursor control NOT affected by cuote 
mode. Therefore, if an error is mode whiJe keying in quote mode, 
the key can't be used to back up and strike over the 

error — even the ( : key produces a reverse video chara cter. In* 
stead, finish entering the line., and then, after hittlnc the f 
key, y'ou -an edit the lire no'tnolly. Another alternative, i f no fur her 
cursor ecrtrols are needed in the string, is ?o press the J^2dES 

arid ES^3 keys which will cancel QUOTE MODE. The cu r soi 
control keys that you can use in strings are shown n Table 2-2. 
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Table 2-2. Cursor Control Characters in QUOTE MODE 

Control Key Appearance 

crsr up HEM n 

CR5R down | Qf 

CRSR left ffiiifr^ g| 

CRSR right (^2S H 

a r GE9H Q 

HOME ■BEES O 

IN5T pBB 



When you are NOT in quote rrode, holding down the EH3 k- e V ar <d 
then pressing the INSerT | ' | key shifts date to the right of the cur- 
sor to uptn up space between two characters for entering data belween 
them. The Editor then begins operating in INStKI MODE until all of the 
space opened up is Filled. 

The cursor control? and color control? again show as reversed ehcr- 
aciers in inse r t mode. The only difference occurs on the DELete and 
INSerT kpy. The | | instead of operating normn'ly ns in 

the quote mode, now creates the reversed | I . The | key, 

which erected a reverse character In quote mode, inserts spaces nor- 
mally. 

Ths means Thar a PRINT statement can be erected, containing DE- 
Letes, wh'cri can't be done in quale mode. The insert mode is cancelled 
by pressing The | II | c,nd Q | , or Q and 

■JSj^^JJ keys, Cr you car cancel the insert medo by filling oil the 
inserted spaces. An example of using DEL characters in strings Is: 



10 print "hello" Em kEI USB mm mSM p" 

(Keystrc-ke sequence shown above, appearance when listed below) 
10 PRINT'HELP" 

When the example is RUN, the word displayed will be HELP, because 
4 he letters LO are deleted before the P is printed. The DELete character 
in strings wifl work with LIST as well as PRINT. You car use this to "hide" 
part or oil of a line of text using this technique. However, trying to edit ct 
line with these characters will be difficult if net impossible. 

?i BASIC LANGUAGE VOCABULARV 



There are some ether character that can be pointed iar special func- 
tions, although they are not easi y available from the keyboard. In order 
to get these irro quotes, you must leave empf/ spaces for then in the 
Ihe, press j 33W?!B . and go back to eel" the line, Nzw you hole down 
the 13TM (CnnTRni) key <™d type | J: (ReVerSe-QN) to stort 

typing reversed characters. Type the keys as shown below; 

Key Function Key Entered Appearance 

Shifted RETURN EflBl PI j^ 

Switch to upper/lower case 
Switch to upper/graphics 



Holding down the key and hitting causes a 

carriage-return and line-teed on the screen bu1 does riot end the string. 
This works with LIST as well as PRINT, so editing will be almost impossi- 
ble If this chnrncter is used. When output is Switched to the printer via 
the CMD statement, the reverse "N" character shifts rhe printer into its 
upper-lower case chcracter set end the ^^J "N" shifts ihe prirtar 
into the upper-ease/greipnics character set. 

Reverse video characters can be inc uded in strings by holding down 

the ConTRol |gm key and pressing RcVcrSc j 3' causing c re 
versed R ro appear hsice the quotes. This will make all characters pint 
in reverse video Jike a negalive of a photograph) To end the reverie 
printing, press [30J end | fflHTB (ReVerSe OFF) by holding 
down the |>j|^ key and typing the | | key, which prints n 

reverse R. Numeric data can be prin-ed in reverse video byfrs* printing 
□ CHR$(18). Printing a CHR$(146) cr a carriage-return will cancel re- 
verse video output. 
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GRAPHICS OVERVIEW 

All nf thfi rjrvuphirs nhiUfiPs nf th<= Comn-odore 64 come from the 6567 
Video Interface Chip (also known as the VIC-ll chip). This chip gives a 
variety of graphics modes, including a 40 column by 25 inR text display, 
c 320 by 2QC dot high resolut'on display, and SPRITES, small movable 
objects which Tiake writing gomes simple. And if this weren't enough, 
many of the graphics modes can be mixed on the same screen, It is 
possible, for example, to define the top half of tie screen to he- in high 
resolution mode, wh'le the bottom half is in text mode. And SPRITES will 
combine with anything! More en sprites later. First the ctnsr graphics 
modes. 

The VIC-ll Clip hg = the following graphics display rriuues; 



A) CHARACTER DISPLAY MODES 

1) Standard Character Made 

a) ROM characters 

b) RAM programme ble choracters 

2) Multi-Color Character Mode 

a) ROM characters 

b) RAM programme ble choracters 

3) Extended Background Color Mode 

a) ROM characters 

d) RAM programmable characters 



B) BIT MAP MODES 

1) Standard Bit Map Mode 

2) Multi-Color Bit Map Mode 



C) SPRITES 

1) Standard Sprites 

2) Multi-Color Sprites 
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GRAPHICS LOCATIONS 

Some general information first. There ore 1000 possible locations on 
th& Commodore 64 screen. Normally, the screen start! ot location 1024 
(£0400 in HEXadecimal notation) and goes to location 2023. Each of 
thess lecctions is 8 bi's wide. This; means that it can hold or.y integer 
number from to 255. Connected with screen memory is a group of 
1000 locations called COLOR MEMORY or COLOR RAM. Thesp start at 
location 55296 ($DS00 in HCX; and go up to 56295. Each of the color 
RAM locations is 4 bits wide, which meons that it can hold any integer 
number -ram to 1 5. Since there are "6 possible colors that the Com 
modcre- 64 can use, this works out well. 

In addition, there are 256 differen- characters that can be displayed 
at any time, For normal screen display, each of the (000 locations in 
screen rnemcry conlu'ns a code number which tells the VIC-II chip which 
character to display at thnt serpen location, 

The various graphics modes are selected by the 47 CONTROL regis- 
ters In the VIC-II chip. Many of ne graph cs functions can oe controlled 
by POKEing the correct value into one »F the registers. The VIC I] chip i E 
located starting at 5324B (SD000 in HEX) through 53294 ($D02E in HEX), 

VIDEO BANK SELECTION 

The VIC-II chip con access ("see") 1 6K. of memory at a time. Since 
there is 64K of memory in lire Commodore 64, you want to be able to 
have the VIC-II chip see oil of it. There is a way. There are 4 possible 
BANKS (or sections) of 1 6K of memory. All that is needed is some means 
of controlling which 16IC bank the VIC-II chip looks at. In that way, the 
chip can "see" the entire 64K of memcry. The BANK SELECT bits that 
allow you access tc nil the different sections of memory are located in 
the 6526 COMPLEX INTERFACE ADAPTER CHIP #2 (CLA #2]. The POKE 
and PEEK BASIC statements (or the r machine lenguege versions) are 
used to select a bonk by controlling bits and ' of PORT A of CIA#2 
(location 56576 for $DD00 HFX)). These 2 bits must be set fa outputs by 
selling bit* and 1 of location 56573 ($DD02 : HEX) to change banks. The 
Tallowing example- shows "his: 

POKE 56573, PEEK[56578)OR 3 :REM MAKE SURE BITS AMD 1 ARE 

SET TO OUTPUTS 

POKE 56576, (PEEK(5657cY)AN D 252}OR A: REM CHANGE 3ANKS 

"A" should have one of *he following values: 
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VALUE 
OF A 


BITS 


BANK 


STARTING 

LOCATION 


VIC'll CHIP RANGE 




1 
? 
3 


00 
01 
10 

11 


3 
2 

[ 



49152 
32768 

16384 



($C000-$FFFFi* 
($8000-$BFFF) 

eMouu-$/f-i : F;r 

($0000-$3FFF) (DEFAULT VALUE) 



This 16K bank corcept is parr of everything that the VIC-I chip does. 
You should always be aware of which bank the VIC II chip is pointing 
at, since this will affect where character data patterns come from, 

wnere tne screen is, where sprites come from, etc. When you turn on the 
power o( your CoiTiri'jdore 64, Lils mid 1 of locution 56576 ure ou~o- 
matically se- to BANK ($000O-S3FFF) for oil display infor-nation. 



j 



*WOTE; ths Conmndore 64 eheracter set is not ovoiiabls to the VPfJ-ll chip ir BANKa 
1 end 3. ISee character msffiDfy lecrioA.) 



SCREEN MEMORY 



The location of screen memory tnn he rhnngeH ensily hy o POIf = to 
control register 53272 ($D01G HEX]. However, this register is also U3ed 
tr> control which character se- is used, so be careful to avoid disturbing 
that part of the control register. Trie UPPER 4 bits control the location o-f 
screen memory. To move the screen, the following statement should be 
used: 



POKE53272,{PEEK(53272)AND15)ORA 
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W^iere "A" hos one of the following values; 



A 


BITS 


LOCATION* 


DECIMAL 


HEX 


C 


0000XXXX 


c 


$0000 


16 


Q001XXXX 


1024 


50400 [DEFAULT! 


32 


0010XXXX 


2043 


$0800 


48 


OOllXXXX 


3072 


$0030 


64 


Q100XXXX 


4096 


SI 000 


80 


0101XXXX 


5120 


$1400 


96 


0110XXXX 


6144 


$1800 


112 


omxxxx 


7163 


$1030 


128 


1000XXXX 


S192 


$2000 


144 


1001 XXXX 


9216 


$2400 


160 


lQIQXXXX 


10240 


$:Z800 


176 


iouxxxx 


11264 


$2030 


192 


nooxxxx 


12288 


$3000 


208 


1101XXXX 


13312 


$3400 


224 


11 10XXXX 


14336 


$3800 


240 


111 1XXXX 


15360 


$3C00 



*R eI fi<siriber diet rfi« BANK ADDRESS of live VIC-II chip must be added in. 

You musl also re II the KERNEL'S steun edilur v»here the itroen ii at Mlomn POKE 

643, page (where pcge - address/536, <s-g ., 1024/254— 4»n POKE 64-8,4). 

COLOR MEMORY 

Color memory can NOT move. It Is always located at locations 55296 
C$0800) through 562?5 (SDBE7). Screen memory (the 1000 locations 
starting at 1324) and color memory ore used differently in the different 
graphics modes. A pidure created in one mode will often look com- 
pletely different when displayed in another graphics mode. 

CHARACTER MEMORY 

Exactly where the VIC-II gets ft character information is important to 
graphic programming. Normally, the chip gets the shape; of the char- 
acters you want to be displayed from the CHARACTER GENERATOR 
ROM. In this chip are stored the patterns which make up the vcrioue 
letters, numbers, punctuation symbols, and the other things that you ses 
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on the keyboard. One of the features of the Commodore 64 is trie abil'ty 
to use patterns lorated in RAW memory. These RAM patterns- are 
created by you, and that means that you con have an almos.1 mfinile set 
of symbols far games, business nriplicntors, etc. 

A normal character set contains 256 characters in which each char- 
acter is defined oy 8 oytes cf data. Since each character tanes up S 
bytes this means that a full character set s 256* B — 2K bytes of memory. 
Since The VIC-II chip looks ar 16K of memory cr a time, there a-e 8 
aassible locations for a complete character set. Naturally, you are free 
"o use less than a full ciaracer set. However, it must still start at one of 
the 8 possible starting locations. 

The location of character memcry is controlled by 3 bits o~ the V C-ll 
control register beared at 53272 (SD018 in HEX notation). Bits 3,2, and 
) control where trie characters' set is. located in 2K blocks. Bit C is ig- 
nored, Remembsr that this is the same register thqt determines, where 
screen memory is lut-ated so avjld disturbing the screen memory bits. To 
change the location of character mepiory, the following BASIC state- 
ment can be used: 

POKE 53272,(PEEK(53272)AND240)OR A 



Where A is one of the following values: 



VALUE 
of A 


BIT5 


LOCATION OF CHARACTER MEMORY" 


DECIMAL 


HEX 





XXXX000X 





$0Q0Q-$C7FF 




2 


XXXX001X 


2043 


$0800-$CFFF 




A 


XXXX010X 


4096 


$1000-$17FF 


ROM IMAGE in BANK 
12 (defajt) 


6 


XXXX011X 


6144 


$lSQ0-$lFFF 


ROiV, IMAGE r BANK 
& 2 


e 


XXXX100X 


8192 


J2000-S27FF 




10 


XXXX101X 


10240 


$2800-$2FFF 




12 


XXXX110X 


12288 


$3000-$37IT 




u 


XXXXI 11 X 


11336 


S3800-$3FFF 





Remember to add in the BANK address. 
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The ROM IMAGE in the above table refers to the character generator 
ROW, It appears r fjluce oT RAM at the above locations in bcnk Q. It 
also appears in the corresponding RAM at locctions 36864- H0959 
(39000-$9FFF) in bank 2. Since the VIC-II chip can only accei; 16K of 
memory at a time, the ROM character patterns appear in the 16K block 
dF memory the VIC-I 1 chip looks at. Therefore, the system wo: designed 
to moke the VIC-II chip think that the ROM characters ere a- 4096-8 191 
;$1000-$1FFF) when your date is in bank 0, and 3c864-40959 
;S900Q-5°FFF) when your date is in bank 2, even though the character 
ROM is ucluully at location 53248-57343 ($D00O-SDrFT). This imaging 
only applies to character data as seen by the V/IC-II chip. It can be used 
for programs, utliei data, ere, fust like any other RAM memory. 



NOtE: 


f these 


ROM images 


get in 


the 


way 


cf your 


ow> 


graphics, 


ttier 


let 


the SANK 


SELECT 


BITS ti 


one ot the 


BANKS w 


rtxjut 


the irnjuei 


■BANKS 


1 or 


3). 


The 


ROM 


pgttern 


5 WOl't 


be tt - 























I he location and contents of the character set in ROM are as follows: 



BLOCK 


ADDRESS 


VIC-ll 
IMAGE 


CONTENTS 


DSCIMAL 


HEX 





5324B 


D300-D1FF 


1000-1 IFF 


Upper case characters 




5376D 


D200-D3FF 


1200-13FF 


Graphics characters 




54272 


D400-D5FF 


1400-15FF 


characters 




54734 


DQ00-D7FF 


1600-17FF 


Reversed graphics 
characters 


1 


55296 


DB00-D9FF 


1600-19FF 


Lower cose characters 




5580B 


DA0O- DBFF 


IA00-IBFF 


Upper case & graphics 
characters 




56320 


DCQQ-DPFF 


1C00-IDFF 


Reversed lower cme 
characters 




56332 


DEQO-DFFF 


1E00-1FFF 


Reversed upper ense & 
graphics characters 



Shnrp-eyed readers will have just noticed somethirg. The locations 
occupied by the character ROM arc the same as the ones occupied by 
the VIC-I [ chip control registers. This is passible because ihey don't oc- 
cupy the same locations at the same time. When the VIC-II chip needs to 
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access character data the ROM is switched in. It becomes an "mage in 
the 16K bonk of memory ihat the VIC-h chip is luokiriy at. Otherwise, 
the area is occupied by the I/O control registers, and the character ROM 
is only available to the VIC- II chip. 

However, you may need to get to the character ROM if you are going 
to Li5e programmable characters and want ta copy sens of the char- 
acter ROM tor some rjf your rhararTer definitions , In thi? ense you must 
switch out the I/O register, switch in the character ROM, and do your 
copying. When ynu're Finished, ynu must switch the I/O registers hack in 
again. During the cooying process {when I/O is switched out) no inter- 
rupts can be allowed to take place. This is beccuse the I/O registers are 
needed to service the interrupted If you forget and perform an interrupt, 
really strange th rigs happen, The keybocrd should not be read during 
the copying process. To tjrn off the keyboard and other normal inter 
rupts that cccur with you r Commodore 64, the following POKE should be 
used: 

POKE 56334, PEEK{56334)AND254 (TURNS INTERRUPTS OFF) 



After you 3re fln'shed getting characters from the characte- ROM. 
and are ready to continue with your program, you must turn the 
keyboard seen back cr by the following POKE; 

POKE 5a334,PEEK(56334)ORr (TURNS INTERRUPTS OH) 



The following POKE wtll switch out I/O and switch the CHARACTER 
ROM In: 



POKE 1,PEEK[1)AND251 



The character ROM is now in the locations from 53248-57343 {SDOOO- 
$DFFF). 

To switch I/O back into $D000 for normal operation us#» the following 
POKE. 

POKE l.FEEKtnOR 4 
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STANDARD CHARACTER MODE 

Standard character mode is the mode the Commodore 64 is in when 
you first turn it on. It is the mode yoj will generally program in. 

Characters con be taken from ROM or from RAM, but normally they 
ere taken from ROM. When you want special graohics characters for a 
program, all you have to do is define the new character shapes In RAM, 
and tell the VIC- II chip "o get its character information from there in- 
stead of The character ROM. Tills Is covered in more detail in rhe next 
section. 

In order to d splay characters on the screen in color, the VIC- 1 1 chip 
accesses the screen memory to determine the choracter cede for that 
location on the screen. At the same time, it accesses rhe color memory 

to dete'mlne what color you vuant to- the character displayed. The 
character code l« Iranslated by the VIC-II into the starting address of the 
8 byte block holding your character pattern. The 8-byte black is locctsd 
in character memory. 

The translation isn't *oo complicated, but a number of items ore com- 
bined to generate the desired address. First the character code you use 
to POKE sceen memo*y is multiplied hy 8. Next add the start af char- 
acter memory (see CHARACTER MEMORY section). Then the Bank Selcd 
Bits are ■'aken into account by adding in the base address (see V'DEO 
BANK SELECTION section), Below Is a simple formula to illustrate what 
happens; 

CHARACTER ADDRESS = SCREEN CO D E * 8 + (C H AR ACT E R 

SET*2048)4(BANK* 16384) 

CHARACTER DEFINITIONS 

Each character is formed in an 8 by 8 grid of dots, where each dot 
may be ei-her on or off. "'he Commodore 64 character images are 
stored in the Character Generator ROM chip. The characters are stored 
as a set of 8 bytes for each character, with -soch byte representing the 
cot pattern of a row In tie cha r ader, and each h\\ representing a dot. 
A zero bit means that dot is off, and a one bit means the dot is on. 

The character memory in RCM begins at location 53248 (when the I/O 
is switched off). The "Irst 8 bytes from locotion 53248 ($3000) to 53255 
($DC07) contain the oattern for the @ sign, which has a character code 
voIjs of zero in T he scrssn memory. The next 8 bytes, from location 
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53256 ($D008) to 53263 (SDOOF), contain the mformcrion for forming the 
letter A. 



IMAGE 


BINARY 


PEEK 


• 4 


0001 1000 


24 


# # *4 


001 11 100 


60 


** ** 


01100110 


102 


****** 


onniio 


126 


#4 e ^ 


011O0T1C 


102 


** ** 


oiioono 


102 


** if * 


3 1 I DO 1 1 


»02 




oooooooc 






Each complete character set takes up 2K (2048 bits) of memory. 8 
bytes per rhnrnrter nnd 266 characters Since there are two chcracter 
sets, one for upper case and graphics and the ct"»er with upper and 
lower case, the characref generctnr ROM takes up n totnl of 4K loca- 
tions. 



PROGRAMMABLE CHARACTERS 

Since the characters are stored in ROM, it would seem that thee is no 
way to change them for customizing characters. However, the memorv 
location that tells the VfC-ll chip where to fr.d the characters is a pro- 
grammable register which can be changed lu point io many ssctfons ol 
memory. By ennngirig the chorocter memory pointer to point to RAM, 
the character set may be programmed for any need. 

If you wont your character set to be located in RAM, there are a few 
VERY IMPORTANT things to take into account when you decide to actu- 
ally program your own character seTs. In add'Tion, rhere ore two other 
important points you must know to create ycur own special characters: 

1) It is an all cr nothing p'ocess. Generally, if you use your own char- 
acter set by telling the VIC-II chip to get the character information 
from the area you have pre pored in RAM, the standard Commo- 
dore 64 characters ore unavailable to you. To solve this, you must 
copy any letters, numbers, or standcrd Commodore 64 graphics 
you intend to use into your own character memory in RAM. Yau can 
pick and choose, Take only the ones you want, and don't even 
have to keep them in order! 
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2) Your character set takes memory space away from your BASIC 
program. Of course, with 38K available for a BASIC program, 
most applications won't have problems. 



WARNINGr You must be care-hj' te protect the character tet ffoir baing e-VBrwr't+«n 

i>y y<sur BASIC program, which □ !&□ W&& -he ftAM. 



There are two locations in the Commodore (sA to start your character 
set that should NOT be used with BASIC: location and location 
204B. The first should not be used because tna system stores important 
data or page 0. The second can't be used because that «s where your 
BASIC progrcm starts! However, there are 6 other starting positions for 
your Ctfilorri character set. 

The best place -*o put your character set for use with BASIC while 
experimenting is beginning at 12288 ($3000 in HEX). This Is done by 
POKEing the low A bits of location 53272 with 12. Try the POKE now, like 
this; 

POKE 53272, (PEEK($3272)AND240} I 12 

Immediulely, all the letters on the screen turn to garbage, This is 
because tnere are no characters set up cit location 12288 right now . . . 
only random bytes. Set the Commodore 64 back to normal by nitting 
the |3l|!RJft I <ey and then the (jJ^jJJJ key. 

Now let's begin creating graphics characters. To protect your char- 
acter set from BASIC, ycu should reduce the amount of memory BASIC 
think* it has. The amount of memory in your computer stays the 
seme, . . it's fjst that you've told BASIC not to use some of it. Type: 

PRINT FRE(0)-(SGN(FRE(0))<;0r 65535 

The number displayed is the amount of memory space left jnused. Now 
type the following: 

POKE 52 / 4B;POKE$6,48;CI.R 

Now type. 

PRINT FRE(0)-(SGN(FRE{0»<0)*65535 
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See the change? BASIC now tninks IT has less memory to work with. The 
memory you fust claimed from BASIC is where you are going to put your 
character set, safe from actions of BASIC. 

The nex - step is to put your cha-acters into RAM. When you begin. 
there is random data beginning 01 12266 (S3000 HEX). You rrust put 
character patterns in RAM (in the same style as the ones in ROM) for the 
VIC-II chip to use. 

The following program moves 64 characters from RQM fo your char- 
acter set RAM: 

5 PRIHTGHBSK142J ■ REM SWITCH ~0 

UPPER CfiSE 

1 9 P0KE52, 4S : POKESt .. 48 ' ::LF " REM RESEPVE ME^ORV 

FDR CHARACTERS 

23 PQKE56334,PEEKCS63343fiNB25'* : REM TURN OFF 

KEVSCRW INTERRUPT TIMER 

33 F0KEi>FEEK<l?nKC23i 'REM SWITCH IN 

CHARACTER 

43 F0R!-8T0Sli ; POKE 1+ 1229S, PEEK* I+S3S4Q} 'NEXT 

5S P0KEl,PEE*:<l>0R4 -REM SWITCH :H L-'C 

53 F0KE5S334..PEEK<:5fc".334>Ofii : REM RESTPRT 

KEVSCRN INTERRUPT TIMER 

7% Fit-ITI 

Now POKE location 53272 with (PEEiC(53272;iAND240)4- 12. Nothing 
happens, right? Wsll, almost nothing. The Commodore 64 is now getting 
it's character information from your RAM, instead of from ROM. But 
since we copied the characters from ROM exactly, no difference can be 
seen. . . . yet. 

You con easily change the characters now. Clear the screen and type 
an @ sign. Mnvp the cursor down a cauple of lines, then type: 

FOR I = 12288 TO 122S8+7;PQKE I, 255 - PEEIC[I) : NEXT 
Ycrn just created a reversed @ sign! 



TIP; Reversed thoracis are full characters with their bit patterns in chciraeter memory 



Nov/ move the cu.'sor up to the program again ana hit 
again to re-'everse the character {bring it back to normal). By Inoking at 
the table of screen display codes, yci- ;an figure out where in RAM each 
rhnrnrter is. Just remembsr that each character takes eight memory 
locations to store, here's a few examples just to get you started, 
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CHARACTER 


DISPLAY CODE 


CURRENT STARTING LOCATION IN RAM 


@ 





12288 




A 


1 


12296 




j 


33 


12552 




;> 


62 


15784 





Remember thot we only took the first 64 characters. Something else 
will have to he done if you want one of the olher characters. 

What if you wanted character numb-c-" 154, a reversed 2.1 V\fell, you 
cculd make it yourself, by reversing a Z, or you could cuoy the set of 
reversed characters from the ROM, o- just ta<e the ore character you 
want from ROM and replace one ol trie cfioracters you have in RAM that 
ycu don't need. 

Suppose you decide that you won't need the > sign, Lei's replace the 
> sign with the reversed Z. Type this: 

FOR 1=0 TO 7. POKE 12784 4- I, 255 PEE K[l + 12496), NEXT 



Now type ci > sicu. 1 1 comes up as a reversed Z. No matter how 
many timos you type the >, it comes out as a reversed 7 (This change 
is really an illusion. Though the > sign looks like a reversed Z, it stil acts 
like a > n c program. Try something that needs a > sifjn. It Aill still 
work fine, only it will look stiange.) 

A quick review: You tan no™ copy characters -rom ROM into RAM. 
You eon even pick and choose only the ones you want. There's only one 
step left in programmable characters (the best step!) . . making your 
own characters. 

Remember how characters ore stored in ROM? Each character is 
stored as a group of eight bytes The hit pcTterns of the bytes directly 
tonlrol the character. If you arrange 3 bytes, one on top of onother, 
and wrta out each byte as eight binory digits, it forms an eight by eight 
matrix, leaking like the characters. When a bit is a one, there is a dot at 
that ocation. When a bit is a ze'o, there is a space at that location. 

When creating your own characters, you set up the some kind of table 
in memory. Type NfcW ane the-n type th s program: 

10 FOR I = 12448 TO 12455 : READ A: HQKfc I. A: NEXT 
20. DATA 60, 66, 163, 129, 165, 153, 66. 60 
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Now type RUN. The program will replnce the letter I with a smile face 
character. Type a few T's to see the -face. Each of the numbers in the 
DATA statement in [he 20 is a row in the smile face rha meter. The 
mat.'ix tor the face looks like this: 



/ 6 5 4 3 2 10 



ROW 
1 

2 
3 
4 
5 
6 
ROW 7 







* 


4 


* 


* 








:• 










* 




• 




* 






* 




# 


* 














:;■: 


A 




tt 






• 




V 


* 


■■r 




* 


" : 




i: 


* 






^ 


* 


* 


-* 







BINARY 


DECIMAL 


00 1 1 1 100 


60 


01000010 


66 


10 100 10 i 


165 


10000001 


129 


10100101 


165 


10011001 


153 


01000010 


66 


001 11 100 


60 





7 


6 


5 


4 


3 


2 


1 
























1 


















2 


















3 


















4 


















5 


















6 


















7 


















Figw 


re 3-1 


. Pro 


jjramr 


noble 


Cha 


otter 


Work 


sheet. 
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The Prog fa m mable Character Vforksheet (Figure 3-1) will help you 
design your own characters, [here is an 8 by & matrix en the sheet, with 
row numbers, and numbers at the top cf each col'j-nn. {If you view each 
row as a binary word, the numbers are the value of thot bit position. 
Each is a oower of 2, The leftmost bit is equal to 128 or 2 to the 7th 
power, the next is equol to 64 or 2 to the 6th, and so on, until ynu rear:h 
the rightmost bit (bit 0) which is equal tc 1 or 2 to the power.) 

Place an X on the matrix at every location where you want a dot To be 
tn your character. When your character is ready you can create the 
DATA statement for your character. 

Begin with the first row. Wherever you placed art X, take the- number 
at The top of the column (the power-of-2 number, as explained above) 
and write- it down. When you have the numbers for every column of the 
first row, add Them together, Write ttis number down, ne*l lu the row. 
This is the number that you will put into the DATA statement to draw this 
row. 

Do the same thng with all of the other rows (1 — 7). When you are 
finished you should hove 8 numbers between and 255. If any of your 
numbers are not within range, reeheek your addition. The numbers must 
be in this range to be correct! If you have less than 8 numbers, you 
missed a row. It's OK if some are 0. The rows are just as importcrvt as 
the other numbers. 

Replace the numbers in The DATA statement in line 20 with the num- 
bers ycu just calculated, arid RUN the program. Then type a T. Ewery 
time you type it, you'll see your own character! 

If you don't like the way the character turned out, just change the 
numbers in the DATA statement and re-RUN the program until you are 
happy with your character. 

That's all there is to it! 



HINT: For best results, always mot* any vert cu line* i» ygur characters at least 2 
dcts {bits) wide. This helps prevent CHROMA noise (color distortion) on yeui- char- 
acters when thsy ore displayed on a TV screen. 
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Here is an exomple of a program using standard pmgrmimable 
characters: 

10 RD1 * EXAMPLE 1 + 

20 REM CREATING PROGRfiMKfffiLE CHARACTERS 

3 1 P0KE56334, PEEK< 5 £334 ;RHH254 ' R0KE1 , PEEK : 1 »RN125l - 

REH TURN OFF KE RNB I/O 

33 F0RI-8T063-REM CHARACTER RfiNGE TO BF COPIED 

FROM ROT 

36 FORJ=ETO? : REM COPV' ALL 8 EVTES PER CHARACTER 

37 P0KEi22S8+l*8+J, PEEK <53E4'3+I*S+.T> ■ REM COPV R 
EVTE 

33 NEXTJ-NEXTI-REH GOTO NEXT BYTE OR CHARACTER 

39 POKE! , FEEK< 1 >0R4 ' P0KE56334, PEEK < 5S33.'- > 061 ' FEM 

TURN ON I/O AMD KE 

465 P0KE53272, c:?EEK (532723 AND2403+12: REM SET CHRR 

FO INTER TO F1ET1. 12288 

6B FORC:HFR=C0TO63:REr1 PROGRAM CHARACTERS 68 THRU S3 

SG FORBVTE»eTO? • REM BO ALL 3 EVTES OF f CHfiRflCTER 

X£Q READ HUrlBES; r rem PERI 1H V67H OF CHARACTER URTFI 

126 P0KE1229S+<S*CHPfR>+EVTE,MLlMBER : REP1 STORE THE 

DATA IN MEMORV 

140 NEXTEVTE ■ HEXTCHRR : REM RLSO COULD BE NEXT BVTE.- 

CHRR 

150 PRI NTCHRS C 14? 5 TRBCSSS 3 CHRIC60 1 i 

133 PRIMTCHR*C61 >TflBC55>CHR*CS23CHR*<e3> 

ISO REM LIKE 150 PUTS THE NEWLV DEFINE! CHBRRCTER3 

ON THE SCREEN 

170 GET=W-REM WRIT FOR USER TO FRESS 3 kEV 

130 IFfi*=""THEHOi:TO;.70:REM IF WC KEVS I.JERE PRESSED, 

TRV AGAIN! 
136 P0KE53272,21 : REH RETURN TU NCRHRL CHARACTERS 
200 BflTR4,6,7,3,7,? J 3,3 REF1 DATA FOR CHFRACTER 60 

219 DftT"f 32, 5&r££*\,im> ££■'-.■ ££4,. 13E, 132*RCT DATA 
FOR CHR^flCTER SI 

220 HRTR7,7,7,3I,21. 1 95,143, :27'REM I'HTR FOR 
3HFRACTER -S2 

235 DATA 22* , 224, 224 , 243.. 248 , 24S-. 24@ . 224 : REM DflTH 
FOR CHARACTER 63 
:j42 END 
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MULTI-COLOR MODE GRAPHICS 

Standard high-resolution graphics give you control of very small dots 
en the screen. Each dct in character memory can hove 2 possible 
values, I for an and for off. When a dot is off, the color of the screen 
is used h the space reserved for that dot. If the dot is on, the do1 is 
colored with the character color you have chosen fo' that screen posi- 
tion. When you're using standard Moil-resolution graphics, oil the dors 
within each 8X8 character car either have beckcround color or fore- 
ground color. Ii some ways this limits the cola' resoluliuii wilhiri thai 
space. For example, problems may occur when two different colored 
lines cross. 

Multi-color node gives you a solution to this problem. Each dot in 
mU'ti-Color 'nod*; cciri be one of 4 colors: Screen Color (bucktjround color 
register #0), the color in background register #], the color in back- 
ground color regisler ^2 r or churacler color. The only sacrifice is in the 
horizontal resolution, because each muti-color mode dot is twice os 
wide as c high-resolution dot. This minimal loss of reso ution is more 
than compensated for by the extra abi ities of multi-color mode. 

MUIXI-COLOR MODE BIT 

To turn on multi-color character mode, set bit 4 gT I fie VIC- 1 1 central 
register at 53270 ($0016) to a 1 by using the fallowirg PO<E: 

POKE 5327D,PEEK(53270)OR 16 

To lorn off multi-color character node, set bit A of location 53270 to a 
by the following POKE: 

POKE 53270, PEEK(53270)AND 239 

Multi-color mode is set on or off for each spoce en the screen, so that 
multi-color graphics can se mixed with high-resuluiiori (hi-res) yruphks. 
This is controlled by bit 3 in color memory. Color memory begins at 
location 55296 t$D8DD in HEX). If fhe number in color memory is less 
than 6 (0-7) the corresponding space on the video screen will oe 
standard hi-res, in the color (0— you've chosen. If the number located 
in colo' memory is greater or equai to E (from 8 to 15), then that space 
will oe displayed in multi-color node. 
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By POKEing a number Info colcr memory, yoj con change the color cf 
the character In that position on the screen. POKEing o number f'om to 
7 gives the normal characte' colors. POKEing a number between B and 
15 puts the space into multi-color mode. In other words, turning BIT 3 
ON in color memory, sets. MULTI-COLOR MODE, Tuning SIT 3 OFF in 
cclor memory, sets the normal, HIGH-RESOLUTION mode. 

Once multi-color mode is set in a space. The bits in the character 
determine which colors are displayed for the dots. For example, here is 
pidurs? of llie letter A, urid its bit pattern: 

IMAGE BIT PATTERN 

** ooonooc 
ooi in co 
onoonc 
omnia 

** ** 01100HC 

** ** 01100110 
•* *• 01100110 

oooooooo 

In normal or high-resolution mode, the screen color is displayed 
everywhere there i= o O hi*, and tie cha'acTer color is displayed where 
the bit is a 1 . Multi-color mode uses the bits in pairs, like so: 






»**t*t 



IMAGE 


BIT PATTERN 


AABB 


00 01 10 00 


CCCC 


00 1 1 1 1 00 


AA3BAAB3 


01 10 01 10 


AACCCCBB 


01 11 P 10 


AA3BAAB3 


01 10 01 10 


AA8RAAB3 


01 10 0" 10 


AABBAAB3 


01 10 0' 10 




00 00 00 00 



In the image area above, the spnres mnrkRd AA are drawn in the 
background #1 color, the 5paces marked BB use the background #2 
color, and the spaces marked CC use the character color. The bit pairs 
determine thia, according to the fo lowing chart: 
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BIT PAIR 


COLOR REGISTER 


LOCATION 


00 


Background #0 color (saeen color) 


532B1 ($D021) 


01 


Background #) color 


53282 f$D022) 


10 


Background #2 color 


33283 ($D023) 


11 


Color specified by -the 
lower 3 bits in color memory 


color RAM 



MOTE: "The sprite foreyro jnd ^olor is a 10. The charocFer foreground coJc-r is cr 1 1 - 



Type NEW and then type this demonstration program: 

100 FCKE53231..1 REF1 SET BACKGROUND COLOR #B TO 

WHITE 

113 F0KE53232,3:REr1 SET BACKGROUND CCL0R #1 TO CVHM 

123 P0KE53233..9 ; RE:ri SET BACKGROUND COLOR #2 TO 

ORANGE 

230 PCKE5327@/PEEK<S3270>OR16:REH TURN ON 

MULTICOLOR NODE 

149 L> 13*4396+8*235: REM SET C TO POINT TO COL FIR 
rlEMQFtV 

150 FRINTCHR*a4?>"FlFfiflfiftfRHF" 
163 FORL=0TOS 

173 PCKEC+4.,8-REM USE WJLTI BLACK 
183 NEXT 



Tne screen color is white, the cha-ader color is black, crc color regis- 
ter Is cyan (greenish blue), the sther is orange. 

You're not really putting color codes in the space for character color, 
you're actually using references to ihe registers associated with those 
colors. This consa-ves memory, since 2 bits can be used to oick I 6 colors 
(butkyiound) ur 8 tolurs (^laraUer). This alsu irakss sume neul liitks 
possiFjIe, Strnply changing one of the indirect registers wil change 3^ery 
dol drewn in tha" color. Therefore everything drawn in the screen and 
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background colors cun be changed on the whole screen instantly, Mere 
is an example of changing background color register #1: 

1@0 POKE53270, PEEK< 53270 >0RIS ! REM TURN ON 

MULTICOLOR NODE 

110 PRIKTCHR*C147)CHf^(JSJ ; 

120 FRIHT'JJT'i ;REM TVFE C"= & 1 FDR 0RRN8E OR 

MULTICOLOR BLACK BRCKCROUNB 

130 FORL-ITOS : PRINTCHR#<65> J : NEXT 

135 F3RT=1TQ5 08-H EXT 

E3D 

146 PRINT ■■"; 'REM TVPE CTRL I: ? FOR BLUE COLOR 
CHANGE 

i 45 FOPT= 1 TO500 : NEXT 



150 PRIHT"iHIT R KEV" 
160 3ETR* I~fl*<s'"THEH|iS0 
its !<=iht':rsd<:i3*16Ii 

180 POKE 532S2..X 
153 GOTO 169 



By using the B key and +h^ COLOR key& the ehnrvieters e^in b& 
changed to any color. Including multi-color characters. For example, 
type this command: 

POKE 53270,PEEK(M270)OR IMPRINT " | | ";: REM LT.RED/ 
MULTI-COLOR RED 




The word READY aid anythirg else you type will be displayed in 
multi-color mode. Arcther color control can set you back to regular text. 
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Here is an example of a program using multi-color programmabla 
characters: 

10 REM * EXfit'PLE 2- * 

SM REM CREfTTINO MULT I" COLOR RRQCRR1WJBLE CHRRRCTEK3 

31 POKE56334 , PEEK '■ 3633-4;:' FIND 234 ; PQKE1 .■ PEEK (. 1 >P)ND25l 

35 FORI =0TO£3 : REM CHARACTER RfthGE TO BE COPIED 
FROM ROM 

36 FOPJ=STC7:REM COPV RLL 8 BYTES PER CHARACTER 

37 P0KE122S3H-I*S+j. PEEK (53243+1*34- J>: REM COFY ft 
BYTE 

3S NEXT J.* I REM GCTO NEXT BYTE OR CHR3RCTER 

35 POKE! .• PEEK< 1 ?OR4 < P0KE36334., PEEK C 55354 ) OR1 : REM 

TURH OH I/O RHU KB 

48 P0KE53S72, iCPEEK<53£7g)flKD240>+12-.f?S l 1 3ET CHRR 

=0 INTER TC MEM. 12208 

50 FOKE5237C, PitEK<5327K>CR16 

51 P0KE333Sl,a:REM SET BRCKGRQUNP COLOR #f TO ELflCK 

52 PQKES3Sa:g..2:«En SET BflCKGKOUNE COLOR #1 TO RED 

53 POKESSSSSjTi^EW SET HRCKGRQUNB COLOR #2 TO 
YELL Oil 

63 FORCH : 1R=S0T0S3 ; REri PFCGRRM GHRRftCTERS 60 THRU 63 

■:.:--! FOREMTEj'GTC?' : REM DO nLL BYTES OF fi- CHARACTER 

L9@ RERBMIJMIER-RSI REfiQ l.-'£"H OF CHARACTER DATA 

1.33 P0KE12S8S4-:b*CHPIR:h-E'tTE. NU'lBEPiREM STORE THE 

OATA IN MEPORV 

14@ l-lEMTgVTE^HRj: 

i'50 , ^^3E iK'iii-! 

PRINT " ^ TirK25?-> 2HR*C60>CHR* CSi >TRE C 55>CHR* ■re2>CHR4 C 535 

160 REH LINE 153 PUTS THE HEWLY DEFINED CHARACTERS 

OH THE SCREEN 

170 G£""H* :f?EM WRIT FOR JSER TO PRESS A KEY 

IBB iFi"l*"""THENt70-REPl IF NO KEV6 UFPE PRESSED, 

TRY AfifllN 

1 39 POKE532?2j 21 ■ PCK£5327€ » PEEK<53£7« ) RNE233 ; REt' ; 

RETURN TO NCRflflL CHARACTERS 

£TO DftTfl J 29 , 37 , 2 1 , 23 , 33 , 35 , S5 . 85 : REM nflTfi FOR 

character se 

213 UHTHtetj, 72, B4, 11.6.. 1 17..85, 85,35: REM rjfiTfl FOR 

CHARACTER SI 

223 IflTR37',S7,S5.-£l. 1 S.,3,40,0 : REri ERTfl FOR 

CHFiRFC T ":R 32 

230 £fti'R3i3j 213, 85, BA , 32, 32, 40, 9:REM DATA FOR 

CHARACTER S3 

£40 ENTl 
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EXTENDED BACKGROUND COLOR MODE 

Extender! background color mode gives you ccrtfol over th« back- 
ground color of each individual charade', as well as over the fore- 
ground color. For example, in this mode you cculd display a blue char- 
acter with a yellow background on a wnite screen. 

There cire 4 registers available for extended background co.or mode. 
Each of the registers con be set to cry of the 16 colors. 

Color memory is used to hold the foreground color in extended back- 
ground mode. It is used the same as in standard character made. 

Extended character mode places a limit on the number of different 
characters you can display, however. When extended color mode is on, 
orly the first 64 characters in tne character ROM (or the frst 64 chn-- 
octcrs in your programmable character set) can be used. This is be- 
cause two of the bits of the character code are used to select the back- 
grouno color. It might work something like this: 

The cnaracrer code (the number you would POKE to the screen) af the 
letter "A" is c 1. When extended co ! or mode is on, if you POKEd a 1 to 
the screen, en "A" would appear. If you POKEd a 65 to the screen 
normally, you would expect the charccter with character code (CHRS) 
129 to upyeur, which is u reveled "A," This does NOT happen in ex- 
tended color mode. Instead you gel "he same unreversed "A" cs before, 
but un u different background color. The fo lowing chart gives the 
codes: 



CHARACTER CODE 


BACKGROUND COLOR REGISTER 


RANGE BIT 7 BIT 6 


NUMBER ADDRESS 


0-63 
64-127 
128-191 1 
■192-255 1 1 


53281 ;$D021) 

1 53282 ;$D022) 

2 53283 ;$D023) 

3 53284 ;$D024) 



Extended c.olcr mode is turned ON by setting bll 6 of the V!C-II regis- 
ter to a 1 at location 53265 ($001 1 in HEX). The Fallowing. POKE dues i'; 



POKE 53265, PEEK(53265)OR 64 
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Extended color mode k turned OFF by gefWrig bit * of the VIC-II regis- 
ter to a at location, 53265 ($D01 1). The following statement will do this: 

POKE 53265, F > EEK(53265)AND 1?1 



BIT MAPPED GRAPHICS 

When writing games, plotting charts for business applications, or 
ether type 3 of programs, sooner or later you get tD trie point wherp you 
want high- resolution displays. 

The Commodore 64 has been designed to do just fhat: high resolution 
is nvoiinble through bit mapping of the screen. Bit mapping is the 
method in which each possible dot (pix.el) of resolution on the screen is 
assigned its own hit {location) in memory. If that memory bit is o one, 
the dot it is assigned to tj en. if the bit is set lu iero, the dot ii off. 

High-resolution graphic design has a couple of drawbacks, which is 
why it is not used oil the time. First of all, it takes lols of memory to bit 
map the entire screen. This is because every pixel must have a memory 
bit to control it, You are gointg to need one bil of memory for each pixel 
(or one byte far & pivels). Since each character is 8 by 8, and there ors 
40 lines with 25 characters in each line, the resolution is 320 pixels (dais) 
by 200 pixels for The whole screen. Thc.t gives you ozrjnrj separate do's, 
each of which requires a bit in memory. In other words, 3300 bytes uf 
memory are needed to map the whole screen. 

General y, high-resolution operations ore made of many shed, sim- 
ple, repetitive routines. Unfortunately, This kind of thing is usually rnther 
slew if you are trying to write high-resolufon routines in BASIC. How- 
ever, short, simple, repetitive routines are sxar-rly what machine lan- 
guage does best. The solution is to either write your programs entirely in 
machine language, or call machine language, high-resolution sub- 
routines from your BASIC program using the SVS comnanc from BASIC. 
Thai wuy you get bctn the ease of writing tn BASIC, and the speed of 
machine language for graphics, The VSP cartridge is also available to 
add higi-resoluTion commands to COMMODORE 64 BASIC. 

All of the examples given in this section will be in 3ASIC to make them 
clear. Nouv ty 1he luthri'ml detail*. 

BIT MAPPING is one of the most popular graphics techniques in the 
computer world. It is used to create highly detailed pictures. Basically, 
when the Comrnudurt; 64 yues irto bit map mode, it directly displays an 
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8K section of memory on the TV screen. When in bit map mode, you cun 
dirsctly control whether an Individual do! on rhe screen is on or off. 

There are two types of bit mapping availab e on "he Commodore 64. 
They ore: 

1) Standard (high-resnlutinn) bit mapped "node (320-dat by 200-dot 
resolution) 

2) Multi-color bit mapped mode H60-dot oy 200-dot resolLtion) 

Each is very similar to the character "ype it is named for: sicndard hcs 
greater resolution, but fewer color selections. On the other hand, multi 
color bit mapping trades horizontal resoJulion for a greate' number of 
colors in an 8 dot by S do* squore, 

STANDARD HIGH-RESOLUTION BIT MAP MODE 

Standard bit map mode gives you a 320 hor'zcrtul cot by 200 vertical 
dot resolution, with a choice of 2 colors in each 8-Hot hy 8-rict section. 
Bit map mode is selected (turned ON) by setting bit 5 of the VIC-II 
eontro register to n I (it location 53265 (5D01 1 in HEX). The following 
POKE will do this: 

POKE 53265, PEEK(53265)OR 32 

Bit mup mode is iumed OFF by setting b"t 5 jf the VIC-I control 
register *o at location 53265 (SD011), like this: 

POKE 53265,PEEK(53265)AND 223 

Before we get into the details of the bit map mode., there is one more 
issue to tackle, and ihat is where to locate the bit mao area. 

HOW IT WORKS 

If you remember the PROGRAMMABLE CHARACTERS section you will 
recall that you were able to s.e1 the bit pattern of a character stored in 
RAM to almost anything you wanted, H ar the same time you change the 
character that is disp ayed on the screen, you would be able to change 
a single dot, and watch it happen. This is tie basis of bit-mapping. The 
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entire screen is filled with programmable characters, and you make 
your changes directly into the memory 'hat the programmable char- 
arters get the>ir patterns from. 

Each of the location; in screen memory thcr were used to control when 
character wets displayed, are novu used for rnlo' infnrmntion. For 
example, instead of POKEirg a 1 in location 1024 1c make an "A" ap- 
pear in the tap left hand corner of the screen, , citation 1024 now con- 
trols the Colors of the bits in that top left space. 

Colors of squares in hit map nrode do not tome from color memory, 
as they do in the character modes. Instead, colo-s are taken frorr 
screen memory The jpper 4 bits of screen memory herome the color of 
any bit that is set to I in the 3 by 3 area controlled by that screen 
memory laca-ion. The lower 4 bits become the colo r of nny hit thn- is set 
to a 0. 

EXAMPLE: Type the following: 



5 BRSE=2*4&3GiPQKE33£?2>PEEKC53£?B>0r?©;REf1 PUT BIT 

MRP fiT 8192 

LB r0KES32S!E,PEEI«53SC5>0R32 , REM ENTER BIT MAP MODE 



Now RLN the program. 

Garbage appears on the screen, righl? Just like tne normcl screer 
mode, you have to clear the HIGH-RESOLUTION (HI-RES) screen before 
you use it. Unforruncrely, printing a CLR won't work in this case. Instead 
you hove to clear out the section of memory thai you're using for your 
p-ogrammable diwruclers. Hit the f&lfflSES and MHMi'iMa keys, then 
add the following lines ~o your p'ogram to clear the hl-RFS screen: 



£B r0P.I-DlXET0ERSE+7EiS l 9 : POKE I . B : NEXT " REM CLEFR FIT 

MRF 

33 FORI "1024702923 ■" POKE! j 3 : MEKT : REM SET COLOR TC 

IVHN HMD BLfiCK 



\lov^ RUN the prcgrcm again, You shoulc see the screen clearing, then 
•he creenish blue color, cyun, should cover the whole screen, What we 
wont to do rov/ is to t.im the dots on ard off on the hl-RES screen. 
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To SET a dot (turn a dot ON) or UNSET a dot (turn a dot OF. c ) you most 
know how to find the correct b't in the character memory ilcjt you have 
to set to a 1 . In other words, you have to find the character you need to 
change, the row of the c'norac'er, and which bit of the row that you 
have to change, You need o formula to calculate this. 

We will use X u:il) Y 1u stand far Ihe hjorwrtal and vertical positions 
of a dot. The dot where X = Q end Y=0 is ct the upper-left of the dis- 
pluy. Dots to the right have higher X vulues, und the dcrs toward the 
bottom have higher Y values. *he besl way tc use bit mapping is to 
arrange the bit r\'j\j display something like this: 



■319 



199- 



Each dot will hove nn X nnd a Y coordinate. With this format it is easy 
to cont'd any dot on the screer, 
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Howe'jer , what you actually have is somethirg like (■his: 



O at 



BYTE 


BYTE 8 BY 


BYTE 1 


BYTE 9 


BYTE 2 


BYTF 10 


BYTE 3 


BYTE ?1 


BYTE 4 


BYTE 12 


BYTE 5 


BYTE 13 , 


BYTE 6 


BYTE 14 . 


BYTE 7 


BYTE 15 



BY It 16 BY IE 24 



8* 



BYTE 320 BYTE 328 BYTE 336 BYTE 344 . 

BYTE 321 BYTE 32? . 

BYTE 322 BYTE 333 

BYTE 323 BYTE 331 

BYTE 324 BYTE 332 

BYTE 325 BYTE 333 . 

BYTE 326 BYIE 334 

BYTE 327 BYTE 335 



.BYTE 312 
BYTE 313 
BYTE 314 
CYTE 015 
BYTE Sid 
BYTE 317 
BYTE 318 
BYTE 319 

.BYTE 632 
BYTE 633 
BY"E 634 
BYTE 635 
BYTE 636 
BYTE 637 
BYTE 638 
BY"E 639 



The programmable characters which rrake up the bit map ere ar- 
'anged in 25 rows o~ 40 columns each. While this is a good method of 
organization for text, it mokes bit rrapping somewhet difficult. (There is 
a good reason for this method. See the section o i MIKED MODES.) 

The following formula will moke it easier to control a dot on the bit 
map screen; 

The stnr- nf the display memory area is krown as the BASE. The row 
njmber (from to 24) of /our dot is; 

ROW = INT(Y/3) (There are 320 byfes per lire.) 
The character posiTion on that line (from ro 39) is: 

CHAR = INT(X/8) (There are 8 bytes per character.) 
The line of that character position [from O to 7) is: 

LINE = Y AND 7 
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The bit of that byte is: 
BIT = 7 (X AND 7) 



Now i/i'e put these formjlas together. The byte in which character 
memory dot (X,Y) is located is calculated by: 

BYTE = BASE + ROW* 320+ CHAR*8 + LINE 



To turn on any bit on the grid w th coordinates (X,Y), use this line, 
POKE BYTE, PEEK(BYTE) OR 2TBIT 



Let'* odd these calculations to the program. In the following example, 
-he COMMODORE 64 will plot a sine e^rve; 

30 F0ftK=anrC31SSTEP.3REM WH^E JJILL FILL THE SCREEN 

60 V»INTC3i*ee*3IH < K/10J ) 

?B CH-INTW8} 

S3 RO«IHT<¥/S> 

@5 LH=VflHD7 

99 BV<BffSE+RQ*328+8*CH+LN 

190 BI*7-CXflND7> 

1 1 a pokebVj peek c f.ivj circ £te i :: 

120 NEXTX 

125 POKE 1024, 1G 

130 C0T013S 



The calculation in line 60 wi I change the values far the sine function 
from a range of + I to — I to a range cf I 3 to I/O. Lines /C to 1 00 
calculate "he character, raw, byte, and bit being affected, using the 
formulae as shown oooi/e. Line I 2i signnls the program is fr.ished by 
changing the color of the top left corner of the 3creen. Line 130 freezes 
the program oy pjrting it into an infinite loop. When you have finished 
looking at the- display, just hold down [ J and hit ^ 
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As a further example, you can modify the sine curve program to dis- 
play a semicircle. Here are the lines to type to make the changes: 

50 H;if;K=9T01S«:REI<1 DO HAL- THE SCREEN 

56 V2=100-SaRi; 1S0*K-X*X3 

60 FORV-Y I T0V2STEPV1 ~¥2 

70 CH-INT<K/33 

30 R0=INT<'-V9S 

35 l,.H=VflHE7 

SC SV»BflSE+RQ#320'«-g*CH+LN 

100 BI*7~r.XRWB7i 

1 10 F'CKE-fiVj F'EEKCEV;! QROTBIJi 

1H NEXT 



This will create a setiic rele in the HI-RES area of the screen. 



WARNING: EASIC variables con c^erlcy yoir hicfWetolution screen. If you need 
more memory spars ynn must mow the bottom o-f EASIC abo^s the high-resolution 
serpen nre;i Cr, you mur mous yojr ligh-rBtdutfcn screen area- This problem will 
NOT occur h mochira langjage. If ON IV happens when -you're writng prog.-omj in 
BASIC 



MULTI-COLOR BIT MAP MODE 

Like multi-color made characters, multi-color bit mop mocfe allows you 
1o display up to four dif-erent colors in each 8 by 8 sttulion of bit map. 
And as in multi-character mode, there is a sacrifice of horizoiral resolu 
tion (from 320 dots to 160 dors). 

Multi-color bit map mnde uses on 8K section of memory tor the bit 
map. You select your colors for multi-colo.- bit map mode from (1) I lie 
background color register 0, [the screen horkgrcj.ind color), (2) the video 
matrix (the upper 4 bits give one possible color, the lower 4 bits an- 
other), and {3} color memory. 

AAulti-cobr bit mapped mode is turned ON by setting oit 5 of 5G265 
($D011) and oit 4 at location 53270 ($0016) to a 1 . The following POKE 
does this; 

POKE 53265, PEE K( 5 3 625)0 R 32: POKE 53270, PEEK(53270)QR 16 
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Multi-color bit mapped mode is turned OFF by setting bit 5 of 53245 
(3D0I I) and bit 4 at location 53270 ($0016) tv a 0. The following POKE 
does This: 

POKE 53265,PEEK(53265)AND 223 : POKE 53270, PEEK(53270)AND 23? 



As in standard (HI-RES) Dit mapped mode, there is a one to one cor- 
respondence between the 8K section of memory being used 'or the dis- 
play, und what is shown on the screen. However, the horizontal dots ore 
two bits wide. Each 2 b ts in the display memory area *orm a dot, wiicri 

tun have one of 4 colors. 



BITS COLOR INFORMATION COMES FROM 
Background color #0 (screen color) 

01 Upper 4 bits of screen memory 

Lower A biH of screen memory 
Color nybble (nybble = 1/2 byte = 4 bils) 



SMOOTH SCROLLING 

The VIC-II chip sLpports smooth $crolling in both the horizontal and 
vortical directions, Smooth scrolling is a one pixel movement of The 
entire screen in one d recrion. Ir con move either up, or down, or left, or 
right. It is used to move new information smoothly onto the screen, while 
smoothly removing characters f-om rhe orlw side. 

While the VIC-II chip does mi.ch of the task for you, the actual scroll- 
ing must be done by a machine language program. The VIC-II chip 
Features the ability to place the video screen in any of 3 horizontal posi- 
tions, and S vertical positions. Positioning is controlled by the VIC-II 
scrolling registers. The VIC-II chip also has a 38 column rrode, and a 24 
row mode. I he smaller screen sizes are used to give you a place for your 
new date to scroll on from. 

The following are llie steps -or SMOOTH SCROLLING: 
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1) Shrink the screen (the border will expand). 

2) Set the scrolling register to molrrum for Tilnlmum value depend- 
ing upon the direction of your scroll). 

3) Place the new data on. the proper (covered) portion of the screen. 

4) Increment (or decrement) the scrolling register until it reaches the 
maximum (or minimum) value. 

5) At this point, jse your machine language routine to shift the entire 
screen one entire character in the direction of the scroll. 

6) Go back to step 2. 

To go into 38 column mode, bit 3 of location 53270 ($D0i6) must be> 
set to a 0. The following POKE doe* this: 

POKE 5327Q\PEEK(53270)AND 247 

To return to 40 column mode, set bit 3 of iocotion 53270 ($D016) to a 
I. The following POKE does this: 

POKE 53270, PEEK(53270)OR 8 

To go into ?4 row mode, bit 3 of location 53265 ($D01 1 ) must be set to 
a 0. The following POKE will oo this: 

POKE 53265, PEEK(53265)AND 247 

To return to 25 row mode, set bit 3 of ocation 53265 ($D01 1) to a 1. 
The following POKE doss this: 

POKE 53265, PEEK(532e5)OR 8 

Whe-i scrolling in the X direction, it is necessary to place the VIC-II 
chip into 38 column mode. This gives new data a ploce to srrnlJ from. 
When scrolling LEFT, the new data should be placed on the right. When 
strolling RIGHT the new data should be placed on The left. Please note 
that there are still 40 columns 1c screen memory, but only 38 are visible. 

When scrolling in rhe ¥ direction, it is necessary to place the VIC-II chip 
into 24 row mode. When scrolling UP, place the new data in the LAST 
row, When scrolling DOWN, place the new data on the FIRST row. Un- 
like X scrolling, where there are covered creas on each side of the 
screen, there is only one covered ureu in Y scrolling. When the Y scroll- 
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ing register is set to 0, the first line is covered, ready for new data. 
When the Y scrolling register is set to 7 the las* row is covered. 

Tar scrolling in the X direction, the stroll register is located in bits 2 to 
of ihe Vlt-ll control register ot location 5327C ($3016 in HEX). As 
always, H is imoortantto af x ect only those Dits. The Following PO<E does 

this: 

POKE 53270, (PEEK(53270)AND 248)^-X 

where X is the X positicr of the screen from to 7, 

For scrolling in the Y di'ection, the scroll register is heated in bits 2 to 
of the VIC II control rcg ste' at location 53265 (SD011 in HEX). As 
always, it is important tc affect only those aits, The following POKE does 

this; 

POKE 53265, (PEEK(53265)AND 24$)+Y 

where Y is the Y position of the screen from to 7. 

To Scroll text onto the screen from the bottom, you would step the 
low-order 3 bits of location 53265 from 0—7, put more data on the 
covered lne> ot the bottom rsf the nrreen, rand then repeol the process. 
To scroll characters onto the screen from left to right, you would step the 
ow-order 3 bits of location 53270 from to 7, print or POKE anctisr 
column of new data into column of the screen, then repeat the pro 
cess. 

If you step the scroll bits by -1, your text will move in the opposite 
direction. 

EXAMPLE: Text scrolling onto the bottom of the screen; 

.10 P0KE53265>FEEK<;532S3>ntre247 'REM CO 

ir-T0 24 FCW MODE 

£0 PRINTCHRtU4?> RE'1 

CLEAR THE SCREEN 

30 FORX=1TOZ4 :PRINTCHES5C 171 i : NEXT RE'I KrjVE 

THE GURSQR TO THE BOTTOI' 

40 P0KE3aaS3*«PEEK<53E6C>i ! lHD£4S>+7 FRINT REM 

POSITION FOR 1ST SCROLL 

5£ PRINT" -ELLO"; 

se FORP^STOOSTEP-l 

7E P0KE53265 , C a E£K < 532SE 5 flHD24G>+F' 

9(3 F0RX-1T050-HEX1 RE1 

DEL.fi 1 - 1 1 OOP 

9@ HEXT--00TD48 
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SPRITES 

A SPRITE ie a special type of user definable character which can be 
displayed anywhere on the screen. Sprites ore maintained directly by 
the VIC-II chip. And oil yoj have to do is tell a sprite "what to look like," 
"what color to be," and "where to appear." The VIC-II chip will do the 
rest! Sprites can be any ot the 16 color* available. 

Sprites can be used with ANY of the other graphics modes, bit 
mapped, character, multi-color, etc., and they'll keep their shape in oil 
of them. The sprite parries lis own color cefiniflon, if< own mode (HI-RES 
or multi-colored), and Its own shape. 

Up to 3 sprites at a time uun be maintained by the VIC-II chip auto- 
matically. More spri-es can ob displayed using RASTER INTERRUPT 
techniques. 

The features of SPRITES ncljde: 

1) 24 horizontal dot by 21 vertical dot si7e_ 

2) Individual color control for each ip-ite. 

3) Sprite multi-color mode. 

4) Magnification (2X) in horizontal, vertical, or both directions. 

5) Selectable Sprite ro backa'ound priority 

6) Fix&dJ sprite to sprite priorities. 

7} Sp ire to sprite; col isiun detection. 

B) Sprite to background collision detection. 



Thsse speciol sprite abilities make It simple to program man/ arcade 
style games. Because the sprites are maintained by hardware, it is even 
possible to write c Qr.cd quality grim© in BASIC) 

Thtro arc 8 sprites supported directly by the VIC-II chip. They are 
numbered f r om to 7. Each of the sprites has h own definition location, 
position registers and co or register, and has its own bits for enable and 
collision detection. 

DEFINING A SPRITE 

Spriies ure defined like prog r arrm able characters are defined. How- 
ever, since the sizg ot the sprite is larger, mare oytes arc needed. A 
spine is 24 by 21 dots, ar 504 dots. This works out to 63 bytes (504/8 
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bits} reeded to de-"ine a sprite. The 63 bytes are urranged in 21 rows of 
3 bytes eoch. A sprite deflation looks like this: 



BYTE 


BYTE I 


BYT 2 


BYTE 3 


BYTE 4 


BYTE 5 


BYTE 6 


BYTE 7 


BYTt 8 



BYTE 60 



BYTE 61 



BYTE 62 



Another way to view hr>w a sprits is created is to take a look at the 
sprite definition block on the bit level. It would lu<A something like Figure 
3-2. 

In a standard (HI-RES) sprite, each bit set to 1 \a displayed in that 
sprite's foreground color. Each bit set 10 fj is transparent and will disolay 
whatever data Is behind it. This is similar to a standard character. 

Multi-color sprites are similar to mulli-mlar characters. Horizontal 
resolution is traded for extra color resolution. The resolution of the sprite 
becomes 12 horizontal dots by 21 vertical dcts. Eoch dot n the sprite 
become; twice as wide, but the number of colors displayab e in the 
sprite is increased to 4. 



SPRITE POINTERS 

Even though each sprite takes only 63 bytes tc define, one mors byte 
is needed as □ place holder at the end of each sprite. Eacf sprite, ihen. 
takes up 64 bytes. This makes it easy to calculate where in memory your 
sprite definition is, since 64 bytes is an even number and in binary it's en 
even power 

Ecch of the 8 sprites has a byte associated i/vrh it called the SPRITE 
POINTER, The sprite pointers corrrol where each sprite definition is lo- 
cated in memory. These 8 bytes are always located os the last bytes 
of the IK chunk of screen memory. Normally, on the Commodo'e 64, 
this means they begin at location 2040 ($07F8 in I ID<). However, if you 
move the screen, the oration of your sprite pointers will also move. 

Each sprite poinver can hold a number from to 255. This number 
points to the defiritron for that sorite Since each sprite definition takes 
^4 bytes, that means that the pointer tan "see" anywhere in the 16K 
block of memory that the VIC-II c.hia can access (since 2i>6*'64 = 16K). 
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If sprits oointer #0, or location 2040. contains the number 14, for 
example, -his means thgt sprite will be displayed using the 64 bytes 
beginning ot location 14*64 = 896 which is in the cassette buffer. The 
following fcrmulc makez this clear: 

LOCATION = (BANK * 16384) 4- (SPRITE POINTED VALUE * 641 

Where BANK s "he 16K segment of memory their the VIC-II chio is look- 
ing ot and is f r orn to 3, 

The above formula gives the start of the 64 bytes of the sprite 
definition block. 

When the VIC-ll chip is looking at BANK or BANK 2, there is a ROM 
IMAGE of the character Sel presenl in cerlufil locations, us mentioned 
before. Sprite definitions can NOT be placed there. If for some reason 
you need more than 1 26 different sprite definitions, you shoulc use one 
of the banks without the ROM IMAGF, 1 or 3. 



TURNING SPRITES ON 

The VIC-II control register at location 53269 (SD015 in HEX} is known 
as the SPRITE ENABLE register. Each of the sprites has a bit in this 
register which confols whether that sprite is ON or OFF. The register 
looks like this: 

$D01 5 7 6 5-13210 

To turn on sprts 1, for example, it is necessary to turn that bi- to a 1 . 
The Wowing POKE does "his: 

POKE 53269, PEEK<53269)OR 2 



A more general statement would be the following: 
POKE 53269. PEF_K(53269)OR (2JSN) 

where SN is the sprite number, from to 7. 



NOTE; A sprite musr be tun-ieJ ON before it can be leen. 
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TURNING SPRITES OFF 

A sprite is turned off by setting its bit in the VIC-II control 'egister at 
53269 (SD015 in HEX) to a 0. The following POKE will do this: 

POKE 53269, PEEK<53269)AND (255-2tSN) 

where 5N Is the sprite number from 1a 7. 

COLORS 

A sprite can be any of The 16 colors gererated ay the VIC-II chip. 
Each of the sprtes has its own sprite color register. These are the mem- 
ory locations of the color registers: 



ADDRESS 


DESCRIPTJQN 


53287 


($DQ27) 


SPRITE COLOR REGISTER 


53288 


<$D028) 


SPRITE 1 COLOR REGISTER 


53289 


($□029) 


SPRITE 2 COLOR REGISTER 


53270 


<£D02A) 


SPRITE 3 COLOR REGiSTER 


53291 


($D02B) 


SPRITE 4 COLOR REGISTth! 


53292 


($D02C) 


SPRITE 5 COLOR REGISTER 


53293 


($DQ2D) 


SPRITE 6 COLOR REGISTER 


53294 


{SD02E) 


SPRITE 7 COLOR REGISTER 



All dots <n the sprite will be displayed in the co'or contained in the 

sprite color register. The rest of the sprite will be rronsparerT, and will 
show whatever is behind the sprite. 



MULTI-COLOR MODE 

Multi-color mode ullows you lu have up lo 4 different colors in euch 
sprite. However, just like other multi-color modes, horizontal resolution is 
cut in half. In ether words, when you're working with sprite multi-color 
mode (like in mulri color character mode), instead of 24 dots across the 
sprite, there are 12 pairs of dots. Each pair of dots is called a BIT PAIR. 
Think of each bit pair (pair of dots) as a single dot in your overall sprite 
when it comes to choosing colors for the dots In your sprites. The table 
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below gives you the bit pair values reeded to turn ON eacT of rhe four 
colors you've chosen For your sprlre: 

BIT PAIR DESCRIPTION 

flO TRANSPARENT, SCREEN COLOR 

01 SPRITE MULTI-COLOR REGISTER #D (53285) (SD025) 

10 SPRITE COLOR REGISTER 

11 SPRITE MULTI-COLOR REGISTER #1 (53286) (SDQ26) 



NOTE; The sprite -foreground color is o 10. The characte- foreground is a II, 



SETTING A SPRITE TO MULTI-COLOR MODE 

To switch u spite inlo multi-color mode yoJ iriLst turn ON the VIC-II 
control register at location 53276 (SD01C). The following POKE does this: 

POKE 53276,PEEK;53276) OR (2fSN) 

where SN is the sprite number (0 to 7). 

To switch a sprite out af multi-color node you must am OFF the VIC-II 
control register at ocotion 53276 ($D01 C), The fol ow'ng FOKE does this: 

POKE 53276, PEEK{53276) AND [255-2t5N) 

where SN is the sprite nuirber (0 to 7). 

EXPANDED SPRITES 

The VIC-II chip has the ability to expand o sarite in the vertical direc- 
tion, the iori7onral direction, or oath af once. When expanded, each dot 
in the sprite is twice cs wide or twice as fall, Resolution doesn't actually 
increase ... the sprite just gets bigger. 

To expand a sprite in the horizontal dirsc"ion, ths corresponding bit h 
the VIC-II control register at lection 53277 (5D01 D in HEX) must be 
tutned ON (set to a lj. The following POKE expand? o sprite in the X 

direction: 

POKE 53277,PEEK[53277)OR <2jSN> 

where SN is the sprite number from to 7. 
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To unexpcnd a sprite in the horizontal direction, the corresponding hit 
in the VIC-II control regfetw a t location 53277 (SD01O In HEX) must be 
turned OFF (sel lo u 0). The following POKE "ynexpands" a sprite in the 
X direction: 

POKE 53277, PEEK{53277)AND <255-2tSN) 

where SN is the sprite number frurn to 7, 

To expend a sprite in the i/srtical direction, the corresponding bit in 
the VIC-II control register u1 location 53271 ($D017 in HEX) must he 
turned CN (set to a 1). The following POKE expands a sprite in the Y 
direction: 

POKE 53271, PEEK(,5327T)OR [2 A SN) 

whe r e SN is the sprite number from G to 7. 

To unexpand a sp'ite In the vertical d reetion, the correspcr.diny bit in 
the VIC-ll control register at location 53271 ($D017 in HEX) must be 
turned OFT (set to a 0). The follawhcj POKE "unexpurids" a sp'ite in the 
Y direction: 

POKE 53271, PEEK(53271)AND (255-2fSN) 
where SN is the sprite number from to 7. 

SPRITE POSITIONING 

Once ycu've made a sprire you want to be able to trove it around the 
sccc-n, To do this, your Commodore 64 uses three posit oning registers: 

1) SPRITE X POSITION REGISTER 

2) SPRITE Y POSITION REGISTER 

3) MOST SIGNIFICANT BIT X POSITION REGISTER 

Each sprite has an X position register, a Y position register, and a bit 
In the X most significant bit regisrer. This lets you position your sprites 

vary accurately. You can placa your sprite in 512 possible X positions 

and 256 possible Y positions. 

The X and Y position registers wor< together, in pai'i, as a team. The 
ocolions of the X ond Y registers appear in the memo r y map as follows: 
Hirst is the X register for sprit© 0, then the Y register tor sprite 0. Next 
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corres the X register for sprite 1, the Y register for sprite 1 , and so on. 
After all 16 X and Y register; comes the most significant bit in the X 
poslTion (X MSB] located in Its own register. 

The chart below lists the locations of each sprite position register. You 
use the locations at their appropriate time through POKE statemen-s: 



LOCATION 


DESCRIPTION 


DECIMAL 


HEX 


53248 


($D0OO) 


SPRITE X 


POSITION 


REGISTER 


5324° 


($00011 


SPRITE Y 


POSITION 


REGISTER 


53250 


($D002) 


SPRITE 1 X 


POSITION 


REGISTER 


53251 


($D003) 


SPRUE 1 Y 


POSITION 


REGISTER 


53252 


[$D0041 


SPRITE 1 X 


POSITION 


REGISTER 


53253 


[$D005J 


SPRUE 2 Y 


POSITION 


REGISTER 


53254 


($D006) 


SPRITE 3 X 


POSITION 


REGISTER 


53253 


($0007) 


SPRITF 3 Y 


POSITION 


REGISTER 


53256 


($D003) 


SPRITE <; X 


POSITION 


REGISTER 


53257 


($0009) 


SPRITE 4 Y 


POSITION 


RFGISTFR 


S325S 


<$D00A) 


SPRITE 5 X 


POSITION 


REGISTER 


53259 


($D00B) 


SPRITE 5 Y 


POSITION 


REGISTER 


53260 


($D00C> 


SPRITE 6 X 


POSITION 


REGISTER 


53261 


($D0OD) 


5PRITE 6 Y 


POSITION 


REGISTER 


53262 


■$D00E] 


SPRITE 7 X 


POSITION 


REGISTER 


53263 


($D00F) 


SPRITE 7 Y 


POSITION 


REGISTER 


53264 


(4 DO 10) 


SPRITE X MSB REGISTER 



The position of a sprite is calculated from the TOP LEFT corner cf the 
24 dot by 21 dot area that yoj- sprite can be designee in. It does NOT 
matter how many or hew few dots you use ro nake up a sprite, Even if 
only one dot is used as a sprite, and you happen to wort it in the middle 
of the screen, you must stil calculate trie exact positioning by starting at 
the top left corner location. 

VERTICAL POSITIONING 

Setting up positions in the horizontal direction is a little more difficult 
than vertical positioning, so we'll diseus3 vertical (Y) positioning first. 

There nre 200 different riot positions that ran ™= individually pro- 
grammed onto your TV screen in the Y direction. The sprits Y positon 
registers can handle numbers up ro 255. Th is means that you have more 
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than enough registe' locations to handle moving a sprite up and down, 
You also want to be able to smooThly move a sprite on and off the 
screen, More lhan 200 values are needed for this. 

The first on-screen value from the top of the screen, and in the Y 
direction for an unexpended sprite is 30. For a sprite expanded in the Y 
direction it would be 9. (Since each dot Is twice as tali, this makes a 
certain amount of sense, os the initial position is STILL calculated from 
the top left earner of the sprite.! 

The frst Y value in which a sprite [expanded or not) is fully on the 
screen (all 21 possible lines displayed) is 50. 

The last Y vclue in which on unexpended sprite is fcly on the screen is 
229. The last Y value h which an expanded sprfre is fully on the screen 
is 208. 

The first Y value in which a sprite is fully off the screen is 250. 

EXAMPLE: 



16 PRINT "i" :REM CLEAR SCREEN 

£6 P(KE£e40, 13 = REM GET SPRITE 

EFlTft -ROM BLOCK 13 

30 F0RI«teT062:PaKES3g+1, 139- - NEKTi EEM POKE SPRITE 

BflTfl INTO BLOCK 13 £13*64=8323 

46 V-53S48 =REM SET BEGINNING 

CF VI DEC CHI" 1 

50 PQr<EV+21,i :REW ENflSLE SPRITE 

1 

€@ P0<EV+3Sfl :REM SET SPRITE 

COLOR' 

70 POKEV-i-1.. 109 :R£J"| SE" SPRITE 

V POSITION 

80 POKE.,J+1S,0'POKEV. 1136 -REM SE~ SPRITE 

M POSITION 

HORIZONTAL POSITIONING 

Positioning in the horizontal direction Is more complicated because 
there arc more than 256 positions. This meens that ar extra bit, o' 9th 
bit Is jsed to control the X position. By adding the extra bit when neces- 
sary a sprite now has 512 possible positions in 'he left/ right, X, direc- 
tion. This makes more possible combinations than can be seen on the 
visible pert of the screen. Each sprite can howa position from to 511, 
However, only those values between 24 and 343 are visible on the 
screen. If the X position of a sprite is greater than 255 (on the 'ight side 
of the screen), the bit in the X MOST SIGNIFICANT BIT POSITION register 
must be sot to a 1 [turned ON). If the X position of a sprite is less than 
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Z 

a 
o 

1 



c 

% 

U 

w 



l«M) 2d (118) 



2H RID) 



50 :m») 



206 (JD0>- 



2 SO i>=A)- 



qae in is 




2J5 (IU) 



2ae (si!8i 
I 



341 (S15HJ 



VISIBLE VIEWING AREA 



MTSC- 

40 COLUMNS 

35 RCWS 




8 {SCSI 



SO 1*32) 



223 (SG51 

— - 250 [JFA) 



I I 

I I 

I I 

I I 

320 (Siflii) 344 (*isb| 



'North American television tr&nsm]s5'0-"i standard? f(?r your no me TV 



? 

VJ 

o 
3 



3 



o 






7 (SOD 31 (sif) 
I I 



33 (S2i) 

54 (S») - ■ 



20J (sec) — 



248 (sFe) 



'13ft -:f t r -i 




31 (S1F1 



SB7 (Si if) 33S (*HF) 

I 



VISIBLE VIEWING AREA 




NTSG- 

38 COLUMNS 
24 ROWS 



- 12 ftocj 



54 «36i 



-2Z5 (5t1> 
-246 (Jl-ei 



I I 

311 ;S137! 336 fl-MFJ 



"Norm ^m&rican le ew&un irsnsmlsslun sicnjaTtfij iur your horn^ TV, 



256 {on the left side of the screen), then the X MSB of That sprite must 
be (turned OFF], Bit? to 7 of the X MSB register correspond to sprites 
to 7, respectively. 

The following program moves a sprit© across the screen: 

EXAMPLE: 



18 PRINT' 

29 PQKE2IMI3, 13 

3& FORI «0TQ62 ■ P0KES32+I, 1£9 : NEXT 

48 V-5324S 

51? POKEVt-21 . :l 

£0 FCKEV+35, 1 

70 POKEV+Ij IBS 

80 FtJRJ=0TO347" 

90 HK«=IWT<J^2565> : LW-J-S5S*H« 

1 @0 POKEV -■ LM : POKEV+ 1 6* HK : NE£T 

When moving expanded sprites onto the eft side of the screen in the 
X direction, ycu have to start the sprite OFF SCREEN on the RIGHT SIDE. 
This is because an expandec sprite is larger ihnn tne nmount of space 
available on the left side of the screen. 

EXAMPLE: 



19 PRINT" rf" 

20 POKE2040. 10 

36 FORI^aTOSa-FOKESSS+I, L 29 = NEXT 

40 V=5324S 

SB PO<EV+21 , 1 

60 F'0<EV+39» 1 : FOKEV+aa . 1 ■ POKEV+29 ■ 1 

70 FCKEV+1. LIB 

£0 J="*SS 

SO HH-XNTCJVaSS) : LX- J-256#HH 

im POKIiiV, LY, ■ PCKEV+ I. S.. HK 

i i@ .t= j+ i : ;: fj>5 i i thehj-s 

120 [FJ}4eroRJ<348S0T0SG 

The charts in Figure 3-3 explain sprite positioning. 

By using these values, you can position each sprite anywhere. By mov- 
ing the sprite a single dot position ul u lime, very smooth movement Is 
easy to achieve. 
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SPRITE POSITIONING SUMMARY 

Unexpended sprites are at best partially visible in the 40 column, by 

25 row made within the following parameters: 

1 < = X < = 343 
30 < == Y < = 249 

In the 38 column mode, the X parameters change to the -cHowing; 

8 < = X < = 334 

In the 24 rovv node, the Y pcrametera change to the following; 
34 < = y < - 245 

Expanded spri*es are ai leasr partially visible In The 40 column, by 25 
row mode within the following parameters: 

489 > - X < = 343 

9 > = y < = 249 

In the 38 column mode, the X parameters change to trie following: 
4?6 > = X < = 334 

In the 24 row mode, the V parameters change to trie following: 
13 < = Y < = 245 
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SPRITE DISPLAY PRIORITIES 

Sprites have the ability to cross each other's peths, as well as cross in 
f r an1 of, or behind other objects on the screen. This can give you a truly 
three dimensioncil effect for gaiies. 

Sprite to sprite prto-ify is fixed, That means that sprite has the high- 
est priority, sprite 1 has the next priority, and so on, until we get to 
sprite 7 S which hcs the lowest priority. In other words, if sprite ' and 
sprite 6 ore positioned so that they rrcss each other, sprite 1 will he in 
front of sprite 6. 

So when you're planning which sprites will appear to be in the fore- 
ground of tne picture, they must be assigned lower sprite numbers than 
those sprites you want to put towards the back of the scene. Those 
sprites wil. be given higher sp-ite numbers. 



NOTE: A "wirHcw" effort i* f>i"5ssih[*v If ri sprfe wilh higher priority hfts "h<li?s" ir» it 
[ar&os where tie do-s are not set to 1 cmd thus turned ON), the sprite with the lower 
priority will show through, Tim also happens with sprite and background dato. 



Sprite to beckgrourd priority is controllable by the SPRITE BACK- 
GROUND priority register located at 53275 :$D01B), Each sprite has a 
bit in the register. It that bit is 0, thct sprire has a higher priority than 
the background an the screen. In other words, the sprite uppeurs in 
front of background data. If that bit is a 1 , that sprite has a lower 
priority than the background. Then the sprite appears behind the sack- 
ground data. 

COLLISION DETECTS 

One of the more interesting aspects of the VIC-! I chip is irs collision 
detection abilities. Collisions can be: detected between sprites, or be- 
tween sprites and background data. A collision occurs when a nan-zero 
pari of a sprite overlaps a non-zerc portion of another sprite or char- 
uclers an the screei. 
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SPRITE TO SPRITE COLLISIONS 

Sprite to sprite collisions ore recognized by the computer, or flagged, 
in the Spite to sprite collision register ot location 53278 ($D01E in HEX) in 
the VIC-II clip control register. Each sprite has a bit in this register. If 
rhct bit is a 1 ., thei that sprite is hvo ved in a collision. The bits in this 
register will remain set until read (PEEKed). Once read, the register is 
auromaticaliy cleared, so it is a good idea to save the vake in a vari- 
able until you ore finished with it. 



MOTE; Collisions can tokc plae-s even when the sprites are off screen. 



SPRITE TO DATA COLLISIONS 

Sprite to cota collisions a'e de+ected in the sprite *o dcra collision 
register at location 33279 (£DQ1F in HEX) q\ Hie VIC-M chip torctrol reyis- 
tpr 

Each sprite has a bit in this register. If that bit is a ' , then that sprite 
is involved in a collision. The bits in this register remain seT until read 
(PEEKed). Once read, the register is automcrically cleared, so it is a 
good tdec to save the value in a variable umil you ore finished with It. 



NOTE. 
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IS REM SPRITE EXAMPLE I... 

20 REH THE HOT AIR BALLOON 

30 VIC" 13*46136: REM THIS IS WHERE I' HE VIC REGISTERS 

BEGIN 

33 FOKEVIC+21, 1 : REM ENABLE SPRITE 8 

36 POKEVIC+33. 14'REM SET BACKGROUND COLOR TO LIGHT 
BLUE 

37 P0KEVIC+23,L:REH EMPF8HI SPRITE 9 IN V 

38 P0KEA'IO23, 1 : REM EXPAND SPRITE 3 IN X 
40 PQKE204B, 192:REM SET SPRITE PCS POINTFR 

186 POKEVIC+9, 13S:REn SET SPRITE 'S K POSITION 

136 POKEVIC+- , 130 -REM SET SPRITE 0'S V POSI"ION 

220 POKEVIC+39,1 REM SET SPRITE O'S COLOR 

256 FORV=ET0e3 : REM EVTE COUNTER WITH SPRITE LOOP 

300 READR:REM KERB IN H BVTE 

310 P0K£192#64*V J R:ftEri STOKE THb EH TH IN SPRITE 

REEfl 

320 HEMTV:REP1 CLOSE LOOP 

330 BM»UEV«i 

340 tt-f>EEK<¥IC>:REr1 LOOK AT SPRITE V 3 * POSITION 

350 V*PEEK<VlC+irREE1 LOCK AT SPRITE 3'S Y POSITION 

3S0 :FV=50OPV=^0eTHEHDV=-I3 , ^ , RE^I IF V IS ON THE 

ETJIjE OF THE. , .. 

370 REM SCREEN, THEN REVERSE DELTA V 

3ES :FH=24RNDCPEEKv7IC-He:inHDi; i -0THCHDM--BX:REn IF 

SFRI~E IS... , 

353 REM TOUCH I KG THE LEFT EUGE CX=24 ^HI THE MSI 

FOP SPRITE IS 0), REVERSE IT 

400 lFK=40HNDt=-EEKC/IC+16)RNDl>=lTHENDX=-IIX-REH IF 

SPRITE IS.., . 

410 REM TOUCHING THE RIGHT EM3E <K«40 RND THE MSB 

FOR SPRITE CJ 13 1), REVERSE IT 

42@ IFK=£55HNBDM=1THEHX=-I SIBE=1 

436 REM SWITCH TO OiHbSI SJUt UH I Hh SCREEN 

440 IFX*e«MDIlX"-lTHENXaS56 : SIDF_=0 

450 REM SNITCH TO OTHER: SI BE 3F THE SCREEN 

460 X=K+m ■ REM PDH DELTF K TO K 

479 X=KANB255 - REM HAKE SURE X IS IN ALLOWED RANGE 

430 V=V+EV:REM HUH DELTF V TO V 

4ys P0KtVIC+16,3IDE 

430 POKEVlC,:<:REI'l PUT NEW X VRLLE INTO SPRITE 0'S 

>■ POSITION 

510 POKEVIC+L,V:REM PUT HEW V VFLUE INTO SPRITE 

0'S V POSITION 

530 GOT0348 

£00 REM. ***** SPRITE DATR ***** 

S19 IiflTAi3,12T. B, 1,233. 192.3,255.224,3.231., 224 

£20 DRTA7..2 1^,240.7., 223. 243, 7. 217., 240, 3.231 .224 

639 DATR3 J 255 J 224 J 3 J 255.224, 2,235., lG9, 1. .127,64 

640 DATA 1,62,54, 6, :36.. 128.. 8, 156; 128, 0,73, 0,0, 7*3 ..0 
650 EATAe, 62, 3.0. £2, 5,0. 62, 0,3, 23, 0,0 
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10 REM SPRITE EXfWPLE 2. . . 

ae rem the hot fir balloon 

30 VIC=13tf40?£ : REM THIS 13 

BEGIN 

3$ POKEVIC+21 

36 POKEv'IC+33 
BLUE 

37 FOKEVTC+23.. 3 
PQKEVIO+23,3 
FOKEE040J 152 
POKE2041, 193 
P0KEaa4£j IC2 
POKE2043, 1SS 
POKE2044,, 1.92 
P0KE2B45, 193 

POKEVIC+4.30 



AGAIN 
WHERE 



THE VIC REGISTER'? 



S^REM ENABLE SPRITES THRU 5 

14: REM SET EfiC<OFOUH3 CCLOR TO LIGHT 



38 

■•IC 
7t 

?a 

30 
9@ 

100 

1 IB 

120 
130 
140 

ISP 

1 r'k 



REM 


E«PIRND SPRITES 


REM 


EXPAND SPRITE? 


REM 


SET SPRITE 0'5 


REM 


SET SPRITE t'S 


PEN 


SET SPRITE 2'S 


REM 


SET SPRITE 3'S 


REM 


SET SPRITE 4'S 


REM 


SET SPRITE 3-S 


MEEf'l SET 'SPRITE 2'" 1 



1 



IH 

IH 



P.NXJ 

a Awn 

POINTER 
POINTER 
POINTER 
POINTER 
P3IHTER 
POINTER 
S X POSITION 

poKEvic+ti.aa-REn set sprite 2"s v position 

P0KEVIC+fif63 : REM SET SFRITE 3'S K POSITION 

P0KEVIC+7,5S i REn SET SPRITE 3'S V POSITION 
POKEVIC+S.iaBtREM SET SPRITE 4'S H POSITICH 
PCKEVIC+9*SSiREM S~T SPRITE 4'8 V POSITION 

ROKsyic*i©/iee'-REM set sprite s's x position 

POKgVH >l 1 . 5 8 : REM SET SPRITE 5'S V POSITION 

E3E 



175 PRINT" fa' I'HBf 1S) 'THIS IS Tl>:0 HI^ES SPRITES 



176 

ISO 

198 

200 

210 
220 

230 
240 
250 
2GP 
2?G 

DEr: 

2SG 

386 

310 

320 
330 
340 
350 
360 

EEGE 

3.'fl 
3S0 

SFRI 
39B 



JN TOP OP ERCH OTHER" 

:REM SET SPRITE 9''S X 

REM SET SPRITE 0'S V 

FEN SET SFRITE I S ;< 



POSITION 
POSEI ION 

POSITION 
POSITION 



e's 
2'S 
4'S 

:. 's 

3'S 



CCLOR 

CCI. OH: 
CCLOR 
CCLOR 
COLOR 
CCLOR 
THE LOOP 



PRINTT3K35>' 

PO<EMC--0, 1E0 

po<evic+i»18@ 

FCKE'viC-2, 100 

POKEVie-^3, USSREM SET SFRITE 1 

P0KEVIC~33j I=REM SET SPRITE 

P0KEMC-4I, 1 -REH SET SPRITE 

P0KEV!O43;l ! REM SET SPRITE 

PO<EV IC+48..6SREM SET SPRITE 

POKE'v I C-42, 6 ■ REN SET SPRITE 

P0KEV1C+44 J 6 : REM SET SPRITE 

F0RM-13£T0i33'l?EM THE START OF THE LOOP THfiT 

NEC THE SPRITES 

F0RV=e.T0€3"REM EVTE GOUHTEP UIT4 SPRITE LOOP 

REFiDfi:REM HERE IH R BYTE 

P0KEX*6«M-V ■ H : REI1 STORE THE 

MEKTVjX REM CLOSE LOOPS 

BX-1 T3V-1 

H=PEEK<VIC:> : REM LOOK AT SPRITE 3'S N 

"i , -PEEK<«IC+l> -REM LOOK FT SPRITE B'S V 

IFV=50ORV=2S3THEHDV=-EV:REP IF V IS OH 

OF THE , , . 
REM SCREEN* THEN REVERSE DELTA V 
I FK=24RHH ' "'EEK < V t C+ 1 C \i AMD! >«0THEI-JEM=-IiX : REM I F 
TE IS. . . 
REM TOUCHING THE LEFT EDGE.. THEM REVERSE IT 



DRTR IF SFRITE HREH 



POSITION 
V POSITION 

THE 
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40@ I FK=4@fiND< PEEK < VI C+16 ) RNDl >«1THEHDX— 3K : REM I F 
SPRITE I?. - . 

416 REM TOUCHING THE RIGHT EDGE, ^HEN REVERSE IT 
420 I FX=255flHBDX= 1 THEMX-- 1 SIBE«3 

*30 REM SWITCH TO OTHER SIDE UP THE. SCREEN 
4-40 :FX=0PHIlI)X=-lTHEH»-«:=256 : ST BE"B 
430 REM SWITCH TO OTHER SIDE OF THE SCREEN 
459 K=X1>IK< = REM REE DELTA K TO H 

473 X=XRNE255 ' REM MAKE SURE K 15 IH RLLOWED RFHGE 

490 V-V+DV=REM REE DELTA V TO V 

495 POKEVIC+ Ira, SIDE 

49© PaKEV'IC,X:RE1'1 PUT NEW X VRLUE INTO SPRITE B'S 

K POSITION 

5S£ POKEVIC+2.. K^EEM FUT HEW N VRLUE INTO SPRITE 

i j e X POSITION 

510 POKEVIC+1 .VREH PUT HEW V VALUE INTO SPRITE 

3'S V POSITION 

52G POKEV'lC+3, V-FBM PUT HEW V VALUE INTO SPRITE 

i'S V POSITION 

5C-T2 GOT 0340 

500 REM «S*** SPRITE IJH'IH ***** 

S1E IiRTH0..253,0,3, 153, 132, 7, 24,224. 7, 36.. 224, 14, 126, 

L 12 , 1 4 , 1 26 , 1 1 £ . 14, ! 26 > 1 12 

620 BflTAS, 126 , 96, 7 , 56 » 224 , 7 , 56, 224 . 1 , 56 , 1 28 , 3, 153 . 

S, 0, :?©, ©, @,56, 

6C« TIHTH3 , S6 , . 0> , & , B, , B * 8 , 1 £!F , f I . , 42 , . , 34 , . , 

40,8, £ 

64£ BflTfi-3,e,0,O, 16 2,0,3,231,6,0,133,0, 1.. 129, 12S, 1, 

125* 128,1,. 129 i 133 

650 DflTRlj. 129, 128,0, 195,0,9. 195,8,4, 195,32, 2, 102, 

54,2,36. S4.1. 0,1£€ 

SS0 DRTfii , £ , i 28, 0, 153 ■ 0, , 1 53, 0,0,0,0,0 , 84 , ©, 0, 42 , 

@,0„20,0,0 



id rem s=-f:ite e«;rmple 3... 

28 REM THE HOT =iIF OORF 

39 V1053S48 F:E1 THIS 13 WHERE THE VIC REGISTERS 

BEGIN 

35 P0KEVIC+S1jL : REW ENABLE SPRITE 
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36 R0KEVIC+33*i4:REM SET BACKGROUND COLOR TO LIGHT 
BLUE 



37 POKEVICh-23, 1 
30 P0KEVIC+29.. 1 
4i3 TOKES040J 192 
Z® POKEVIC+28,1 
60 PQKEVIC+37,7 



:REM EXFRNH SPRITE R IN V 
:REM SKPRNB SPRITE IN X 
: REM SET SPRITE @ J S POINTER 
■REM TURN ON nULTI COLOR 
: REM SET MULTICOLOR 9 
76 POKEVIC+33/4-REf! SET MULTICOLOR 1 
,T30 POKEVIC+0, ICQ: REM SET SPRITE 0'S W POSITION 
190 PO<EVIC+-l, IM-REin SET SPRITE B'"3 V POSITION 

aae fokevic+39*2> - refi set sprite e*"s color 

£90 F0RV-0TQS3 ■ REM BYTE COUNTER WITH SPRITE LGOP 

300 RERDfl:REH RERD IN Fl BYTE 

310 POKEi2208+V»fl'R£M STORE THE DRTft IN SPRITE RRER 

320 NEXT V-'REM CLOSE LOOP 

330 BM«1 :IlV=l 

340 Ks=PEEK<VIC> : REM LOOK R7 SPRITE 0'S H POSITION 

SS0 V=*PEEK{VTC+1>:REM LOOK HT SPRITE B'S V POSITION 

360 :FY=30OEY=20STH£NDY=-I)V-REI-I IF V IS ON THE 

EIGE OF THE. . . 

370 REM SCREEN, THEN REVERSE DELTA V 

3f0 IF N!^4flHD<reEK<VIC*i€>fllKB31?==8THEHrX«-DX;REM 

IF SPRITE IS. . . 

3313 REM TOUCHING THE LEFT EKGE, THEN REVERSE IT 

aae i f x=48hn n <■ peek c vic+icj hmtji s*it heww»-ijx : rf m . p 

SPRITE IS. . , 

410 REM TOUCHING THE RIGHT EDGE, THEN REVERSE IT 

428 lFX-25SflHDBK=lTH£NH=>-l : SIDE=1 

430 REM £WI~CH TC - HER SIDE OF THE SCREEN 

440 IFX=GRHBB»=-lTHENtf=25S : SIBE=Ei 

450 REM SWITCH TC OTHER SIDE OF THE SCREEN 

460 X=K+DH=REn REU BELTFH K TO X 

470 X-WRHD255 ; REr- MAKE SURE K IS IN ALLOWED RHHCE 

430 V*=V+DV : REM FUJI DELTR V TO V 

485 FOKEVIC+lS,Si:0E 

490 POKEVIC,X:REM PUT MEW X VRLLE IHTO SPRITE J S 

«: POSIT [I.1N 

510 P0KEV1C+J . V:REH PUT NEW V VALUE INTO SPRITE 

B'S V POSITION 

3££ OETR*:REN GET R KEV FROM THE KEYBORRD 

521 IFRf= M M"THENF0KEVIC+28,l ^En USER SELECTED 

MULTICOLOR 

323. IF"FI* = "H M THE;JPaKEVIC+2S,9:REP - USEE SELECTED 

HIGH RESOLUTION 

"530 OOTO340 

S0g REM •**** SPRITE 3R7R ***** 

618 BATHS'* , 6 . 1 , IS, 1 70, 4,6,1 70, 144 , 1 3 . 17E , 1 GO , 42 , 

1 70 .. 1 68 , 4 1 , 1 05 , 1 04 , 1 69 , 235 , 1 OS 

S20 IinTRli;9,2S5, 106, 169,22E> 10£, 173, 1?$.. 179, £73, 

170, 170. 170, 170, 170, 170, 170, 173 

630 IIRTR16G, -.70, 154, 169,85, IBS, V. : 'l : ! 85 , 17B .42 , 170 . 

IS8, 10, 170, 160, 1,0,64, 1,0,64 

64S BfiTFiS, 0,50-0 
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OTHER GRAPHICS FEATURES 

SCREEN BLANKING 

Bit 4 of the VIC-ll control register controls the screen blanking func- 
tion. It is found in the control register at location 53265 ($D01 1). When it 
is turned ON (in other words, set to a I) the sz'een is normal. When bit 4 
is ser to (turned OFF), the entire screen changes to border color. 

The following POKE blanks the screen. No data is est, it Just isn't 
displayed. 

POKE 53265, PEEK(53265]AND 239 

To bring back the screen, use the POKE shown below: 

POKE 53265, PEEK(53265)OR 16 



NOTE: Tuffiing off trie Strega will spBed up ihe processor slightly This means that 
program RLfNning Is also sped up. 



RASTER REGISTER 

The roster register is fojnd in the VIC-ll chip at location 53266 
($D012). The raster re g iter is a cual purpose register. When you ead 
tn is 'agister it returns the lower 8 bits of the current raster position. The 
raster position o L the most significant bit is in register location 53265 
($D01 I). You use the raster register to set up timing changes in your 
display so that you can get rid of screen flicker, The changes or your 
screen shctld be mride uvhen the roster is nrji in the visible display oreo, 
which i; when your dot positions foil between 51 and 251. 

When the rasrer registe r is wirten to (including the iVi5B) the rumber 
written to is saved for use with ihe raster compare function. When the 
actual raste' value becomes the same a; tne number wr'tten to the 
raster -egister, a bit in the VIC-ll chip interrupt register 53273 ($D019) is 
turned ON by setting it to 1. 



MOTE: If tile prcper interrupt bit is enabled (turned on], an nterrupt (IRQ) will occur. 
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IMMC 
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ILP 


3 


IRQ 
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INTERRUPT STATUS REGISTER 

The Interrupt status register shows the current stctus of any iritecup 7 
source. The current status of bft 2 of the interrupt register will be a 1 
when w sprites hit each other. The same is true, in a corresponding 1 
to 1 relationship, for bits 0—3 listed in the chart below. Bit 7 is also set 
with a 1, whenever an interrupt occurs. 

The interrupt status register is located ot 53273 (SD019) and h as 
follows: 

UTCH BIT # DESCRIPTION 

Set when current raster count = stored raster count 
5et by SPRITE-DATA collision (1st one only, until resst) 
Set by SPRITE-SPRITE collision (Is* one only, until reset) 
Set by negative transition of Ight pen (1 per fame) 
Set by latch set and enabled 

Once an Interrupt bit has been set, it's "Ictched" in and must he 
cleared by wrting a 1 to that bit in the interrupt register when you're 
ready to handle it. This allows selective interrupt handling, without hav- 
ing to store the other Interrupt bits. 

The INTERRUPT ENABIE REGISTER is located at 53274 ($D01A). It has 
the same format as the interrupl status regisler. Unless the correspond- 
ing bt in the interrupt enable register h set to a 1, no interrupt from that 
source will Take place. The Interrupt status regisler tan still be polled for 
information, but no interrupts will be generated. 

Ta enable an interrupl request the corresponding interrupt enable bit 
(os shown in the chart above) must be set to a 1 . 

This powerful interrupt structure lets you use split Screen modes. For 
instance you can have half of the screen bit mapped, h«lf te5Cf, more 
thun S spriles at a time., etc, The secret is to use interrupts properly. For 
example, If you want the top haK of thr? snreen to be bit -napped anc 
the bottom to be text, just set the raster compare register {as explainec 
previously) for halfway down the screen. When the irtsrrupi occurs, tell 
the VIC-H chip ta got chcracte's from ROM, then set lhe raster compare 
register to Inter-up- at the top ot" The screen. When the interrupt occu-s 
at the top of the screen, tell the VIC-II chip to get characters -from RAM 
(bit map rrade). 
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You can also display more than sprites in the same way. Unfortu- 
nately BA5IC isn't fast enough to do this very well, So (f you want to stnrt 
using display interrupts, you should work in machine language. 

SUGGESTED SCREEN AND CHARACTER 
COLOR COMBINATIONS 

Color TV sets are limited in their ability to place certain crj.ors next to 
each other on the same lire. Ceroin eoTibinatons o+ screen and char- 
acter colors produce bluired iinuues. This chart shows which colo" com- 
binations to avoid, and which work especially well together 



c 
j 
o 
u 
z 

LU 
LU 

cr 
O 
w 
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13 
14 
15 
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PROGRAMMING SPRITES— ANOTHER LOOK 

For those of you having trouble with graphics, this section has been 
designed as c more elementary tutorial approach to sprites, 

MAKING SPRITES IN BASIC— A SHORT PROGRAM 

There ere at least three different 3ASIC programming techniques 
which let you create graphic images and cartoon animations on the 
Commodore 64. You can use the computer's built-in graphics character 
set (see Page 376). You can program your own characters [see Page 
103) or . . . best of all . . . you can use the computer's built-in 'sprite 
graphics." To illustrate how easy it is, here's one of the shortest 
spritemoking programs yoj can write in BASIC; 

LB PKlNT"d" 

20 FOKE2Q40,' 13 

30 FORS-83ST0B35+S2 ; POKES,. 255 : NEXT 

46 V«=53243 

50 POKEV+21.. 1 

60 FQKEV+SS'j 1 

■F0 P0KEV.-24 

SO POKEV+1 j ;LO0 

This, program induces the key "ingredients'' you need to create any 
sprite. The POK-t numbers come from the SPRITEMAKING CHART on 
Page 176. This p-ograrn defnes the first sprite . . . sprite . . . as a 
solid white square on the screen. Here's a line-by-ltne explana-ion of the 
program; 

LINE 10 clears the screen. 

LINE 20 sets the "sprite pointer" to where the Commodore 64 will 
read its sprite data from. Sprite is set at 2040, sprite 1 at 2041, sprite 
2 at 2042, and so on up to sprite 7 ct 2047 '. Ton can set all 3 sprite 
pointers to 1 3 by using this line in place of line 20: 

20 FOR SP=2040TO2047:POKE SP,13;NEXT SP 

LINE 30 puts, the first sprite (sprite O) into 63 hyteS of the Commodo'e 
64's RAA\ memory starting at location 832 (each sprite requires 63 bytes 
of memory). The first sprite (sprite 0) is "addressed" or memory locations 
832 to 894. 
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LINE 40 sets the varia&le "V" equal to 53248, the starting address of 
the VIDEO CHIP. This entry lets js use the form (V + number; for sprite 
settings. We're using the form (V+rumberi when POKEing sprite settings 
because this format conserves memory and lets us work with smaller 
numbers. For example, in line 50 we typec POKE V + 21 . This is the same 
as typ'ng POKE 53243 + 21 or POKE 5326* ... out V + 21 requires less 
space than 53269, and is easier to remember. 

LIME 50 enable; or "1«jrns on" sprite 0. There ere 8 sprites, numbered 
from to 7. To turn on an individual sprite, or o combination of sprites, 
oil you have to da is POKE V + 21 followed hy n numher from (turn all 
sprites off) 1o 255 (turn all 8 sprites on), You can turn an one or more 
sprites hy POKEinrj the following numbers: 



A Li ON 


SPRITEO 


SPRITE! 


spumja 


spsrrc:- 


SPRITE 4 


SWITES 


SMIT16 


SMITE7 


AIL OFF 


V+2I,2SS 


V+31,1 


V+21, 1 


V+21 ,4 


V+21,8 


V + 21,1* 


V+21,33 


v+ai,w 


v4-si,isa 


v + 2i,0 



POKE V + 21, 1 turns on sprite 0. POKE V+21 , 1 28 turns on sprite 7. You 
can also rum on combinations of sp'ires. For exomple, POKE V + 21, 129 
turns on both Sprite D and sprite 7 by adding the two "turn on" numbers 

(1 + 126) together. (See SPRITE/WAKING CHART, Poge 176.) 



LINE 60 sets the COLOR cF sprite 0. There are 16 possib e sprite 
colors, numbered from (bock) to 15 (grey), Eoch sprite requires a 
different POKE to set its color, from V-39 to V+46. POKE V + 39,1 
colors sprite white. POKE V-t-46, 15 colors sprite 7 grey. (See the 
SPRITEMAKING CHART for more information.) 

When you create a sprite, as you just did, the sprite will STAY IN 
MEMORY until you POKE it off, redefine it, or turn off your computer. 
This lets you cinnge the color, position and even shnpe of the sprite in 
DIRECT or IMMEDIATE mode, which i3 useful for editing purposes. As an 
example, RUM the program above, 1her type this line in DIRECT made 
(without a line numbe') and hit the _ j, l key: 



POKE V+39,fl 

The sprite or the screen is now ORANGE. Try POKEing seme other num- 
bers from to l 5 to see the other sorite colors. Because you did this In 
DIRECT mode, if yau RUN your program the sprite will return to its origi- 
nal color [white). 
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LINE 70 determines the HORIZONTAL or "X" POSITION of the sprite 
on the screen. This number represents the location of the UPPER LEFT 
CORNER oi the sprite. The farthest left horizontal (X) position which you 
can see on your television screen is position number 24, although you 
can move the sprite OFF THE SCREEN to position number Q. 

LINE 80 determines the VERTICAL or "Y" POSITION af the sprite. In 
this program, we placed the sprite at X (horizontal) position 24, and Y 
(vertical) position 100. To try another location, tyne this POKE in DIRECT 
■mode ana hh 



POKE V,24:POKI V-H,S0 

This places the sprre at the upper left comer of the screen. To move the 
sprite to the lower left corner, type this: 

POKE V f 24:POKE V + 1,229 

Ccich number from 832 to 695 in our sprite address represents urie 

block of 3 pixels, 'A'i-h three S-pixel blocks in each horizonta' row af the 
sprite. The loop in line 80 tells the corrpuler to POKE 832,255 which 
makes the first 8 pixels solid . . then POKE 833,255 to make the seco-id 
8 pixels solid,, and jo on to location 894 which is the las - group of 8 
pixels in the bottom right corner of the sprite. To better see how this 
works, try typing the following in DIRECT mode, and notice that the 
second group of 8 pixels is erased: 

POKE 833,0 (to put it bock type POKE 833,255 or RUN your program) 

The following line, which you con add -o your program, erases the 
blocks in the MIDDLE of the sprite you cecred: 

90 FOR A = 836 TO 891 STEP 3:POKE A,0:NEXT A 

Remember, the pixels thai ma<e up the sprite are grouped in blocks of 
eight. This line erases The 5th grojp of eight pixels (block 836) and every 
third block up -o block 890. Try POKEing any of the olhcr numbers from 
832 to 894 with either O 255 to make them solid or to make them 

blank. 
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CRUNCHING YOUR SPRITE PROGRAMS 

Here's a helpful 'Crunching" tip: The pogrom daicribed obcwe is already short, but it 
cCn be made even shorter by "crunching" it smoller. In our exarr.ple we list the key 
sprite settings on separate prog rem lines so you can tee what's happening ir ths 
proa/am. In actual prnrtirp-, n rj.mrl prc>rjrnmm.eT wojld probably write this pr&grtirr 
os a TWO UfJf PBDGBAM by "cnjiching" it os -FoTowSr 

10PRINTCHR$C147]:V=5324S:POKEV + 21,1:POKE2040,13: 

POKEV 1-39,1 
20FORS = 832TOB94:POKES,255 : NEXI:POKEV,24:POICEV-l r 100 

For more tips on houv lo crunch your programs so thery fit ir less memory and run mo'e 
efficiently, see the "crunching eude' on Page 24 
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A Sprite located here must have both its 
X-jjusition (horizontal) and V-positlon (vertical) 
set so it can be displayed on the screen. 

Figure 3-4, The display screen is divided into a grid of X and Y coor- 
dinates. 
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POSITIONING SPRITES ON THE SCREEN 

The entire display screen is divided into a grid of X and Y coordi- 
nates, like c graph. The X COORDINATE is the HORIZONTAL position 
across the screen and the Y COORDINATE is the VERTICAL position Jp 
and down (see Figure 3-4). 

Tu position any sprite on the screen, you must POKE TWO SETTINGS 
. . . frits X positron and the Y position , . . these tell the computer where 
to display the UPPER LEFT HAND CORNER of the sprte. Remember thcT 

a Sprite consists of 504 individual pixels, 24 across by 21 down ... so if 
you POKE o sprite onto the upper left corner of your screen, the sorite 
will be displayed =is a graphic imoge 24 pixels ACROSS and 21 pixels 
DOWN starring ut the X-Y position yoj defined. The sprite will be dis- 
played based on the upper left corner of the entire sprite, even it you 
define the sprite using only a small part of the 24X21 -pixel sprite area. 

To understand how X-Y positioning works, study the following dia- 
gram (Fic-ure 3-5], which shows the X and Y numbers in relation to your 
display screen. Note that the GREY AREA in the diagram shows your 
television viewing orea . . . the wh ; te area represents positions which 
are OFF your viewing screen . 

X POSITIONS RUN FROM TO 255, 
2J.' IHEN YOU rciUSTTPOKfc V+16, 1 255 

i-< — r AND START OVFR AT (J IO 91 — ■" 
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X - E4. V - 250 



TCKE V-l-6, 1 AND 

X = 65, Y = 229 



Figure 3-5. Determining X-Y sprits positions. 
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To disolay a sprite in a given location, yet must POKE the X and v 
settings for each SPRITE . , . remembering that every sprite has its own 
unique X POKE and Y POKE. The X and Y settings for all 8 sprites are 
shown here: 

POKE THESE WLUES TO SET X-Y SPRITE POSITIONS 





SPBITEO SPRITE] 


SPRITES 


SPBITE3 SPRITE* 


SPRITES 


SMITES 


SfBlTCJ 


SET X 
SET Y 

HIGH7X 


V 1 1,1 

V+1S1 


V+2.X 

v i i,y 

Vt-ltV,2 


'/I 5,Y 
','-16.4 


V+6.X V + B.X 
VI7Y V+9,Y 
V+16,B | V+l&.fl 


v+iax 

V 1- 1 1,1 

V+ 16,32 


V+ I2,X 

V 1-13," 

v-:«,64 


V+U.X 

V 1 1 5,Y" 

V + 16,128 



POKEING AN X POSITION: The possible values of X are to 255, 
counting from left to right. Values to 23 place all or pert of the sprite 
OUT OF THE VIEWING AREA off The left side af the screen . . . values 24 
to 255 place the sprite IN THE VIEWING AREA up to the 255th position 
(see next paragraph for settings beyond the 255th X position). To place 
the sprite at one of these positions, just type the X-POSITION POKE for 
the sprite you're using. For example, lu POKE sprite 1 at the farthest left 
X position IN THE VIEWING AREA, types POKE V + 2,24. 

X VALUES BEYOND THE 255TH POSITION: Ts get beyond the 255th 
position across the screen, you need to mcke □ SECOND POKE using the 
numbers in the "RIGHT X" row of Hie chart (Figure 3-5). Normally, the 

horizontal (X) numbering would continue post the 255th position to 256, 
257, etc., btt because registers only contain 8 biTs we must use a "sec- 
ond register" to access the RIGHT SIDE of the screen and start our X 
numbering over again at 0. So to get heyend X position 255, you must 
POKE V-M6 end a numoer (depending on the sprite), This gives you 65 
additional X positions (renumbered from to 65) in the viewing area an 
the RIGHT side of the viewing screen. (You can actually POKE Ihe right 
side X vuljs us high us 255, wnich luk.es you off the right edge of the 
viewing screen.) 

POKEING A Y POSITION: (he possible values of Y are to 255, count- 
ing from lop Icj boiturn. Values lo 49 place all or part of the sprite OUT 
OF THE VIEWING AREA off the TOP of the screen. Values 50 to 229 place 
the sprite IN THE VIEWING AREA, Values 230 1o 255 place u I or purl af 
the sprite OUT OF THE VIEWING AREA off the BQTIOM of the screen. 
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Let's see how This X-Y positioning works, using sprite 1. Type this pro- 
gram: 



10 F'RIHT ,, :t i -V=5j!!S4S- PriKIEV+21 ■ g-"PGKE204i ■ 1^: 
F0RS-832TGS95 ■ POKES .. 253 : NEXT 
£0 FOKEV+40,7 
30 PDKEV+2/24 
43 PFJKEV+3,50 

This simple program estaolishes sprite 1 as a solid box end positions it 
at the upper feft come' of the screen. Now change line 4-0 to read: 

40 POKE V-3,22? 

This moves the sprite tc the bottom left corner of the screen, Now efs 
test tne RIGHT X LIMIT of the sprile. Charge line 30 as shown: 

30 POKE V+2,255 

This moves the sprite to the RIGHT but reaches the RIGHT X LIMIT, which 
is 555. At this point, th& "most significant bit" in register 16 must be SET. 
In other words, you must type POKE V-H6 und the number shown in the 
"RIGHT X" column ir> the X-Y POKE CHART above to RESTART the X 
position counter ot the 256th pixel/position on the screen. Change line 30 
as follows: 

30 POKE V-H6, PEEK(V + 16)OR 2:POKE V + 2,D 

POKE V-f J6 r 2 sets the most significant bit of the X position for sprite 1 
und restarts it at the 25&rh pixel/position on the screen. POKE V+2,0 
displays the sprite at the NEW POSITION ZERO, which fs now reset to the 
256ti pixel, 

To get bock to tfte feff side of the screen, you must reset the most 
significant b':t u, r roe X uuaitioti counter ;o by typing (for sprite 1); 

POKE V+16. PEEK(V-16)AMD 253 

TO SUMMARIZE hnw ths» X positioning wnrks . . POKt the X POSI- 
TION for any sprite with o number from to 255. To access a position 
beyonc the 255th position/pixel across the screen, you must use an ad- 
ditlona POKE (V i 16) which sets the nosf significant bit of the X position 
and start counting from agoin at the 256fh pixel across the screen, 
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This; POKE starts the X numbering over again from at the 256th posi- 
ton (Example; POKE V+3 6, PEEK(V + T$)OR 1 and POKE V,J must be 
included to olacc sprite at the 257rh pixel across the screen.) To get 
back to the left side X oos'tions you have to TURN OFFlhe control setling 
by typing POKE V+16, PEEK{V+ 16)AND 254. 

POSITIONING MUUIPIE SPRITES ON THE SCREEN 

Here's a program which defines THRtb DlFhbRENI SPKFE5 (0. 1, and 
2) in different color* and plai.es them in different positions on the 
screen' 



10 P'RlHT ,, 3';V«-S3£40:r0RS»332T0Q?5 POKES, 255- NEXT 

213 F0RM-2GM 0TO2f;-12 "F'C'KEM >:, 3 : ^EI-iT 

3tf PGKEV+21 , 7 

4S1 POKEV+39 . 1 = RGK-EV*-»0 - 7 : P.OKEV+4 1 . 8 

30 POKEV ,i £4 : PDKEV+1 , 50 

60 P0KEW2. 12 'P0KEV+3,£29 

70 FCKEV+4. 255 :F0KEV+5, 59 

For convenience, cl 3 sprites have been defined us solid itiuures, 
getting their dots from the same place. The important lesson here is 
how the 3 sprites are positioned. The while sunle G s <ji Ihe lop leflliund 
earner. The yellow sprite 1 is at the bottorr lefthand corner but HALF the 
sprite is OFF THE SCREEN (remember, 24 is the leftmost >! position in the 
viewing area . . . or X position less than 2& puts ell or part af the sprite 
off the screen and we used an X position 12 here which put the Spr te 
halfway off The screen). Finally, the orange sprite 2 is at the RIGHT X 
LIMIT (position 255) . . , but what if you want to display a sprite in tie 
area to the RIGHT af X position 255? 

DISPLAYING A SPRITE BEYOND THE 355TH X-PQSITION 

Displaying a sprite beyond the 255th X position reqjires a special 
POKE which SETS the most significant oit ot the X position and starts over 
at ihe 25<5th pixel position across the screen, Here's how It works , . . 

first, you POKE V + 16 with the number tor the sprite you're using 
(check the "RIGHT X" row n the X-Y chart . . . we'll use sprite 0). Now 
we assign an X position, keeping in mind that the X counter starts over 
from at the 25cth positicr on the screen. Change line 50 to read as 

follows: 

SO POKE V+16,l:POKE V,24 ; POKE V+1,75 
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This line POKEs \/+16 with the number required to "open up" tho right 
side of the screen. . .the new X position 2^ far sprite now begins 24 
pixels to the RIGHT of position 255. To chBck + he right edge of the 
screen, change line 60 1o; 

60 POKE V + T6J;POKE V,65;POKE V+L75 

Some experi mentation with the seTings in the sprite chart will give you 
the settings you need to position and move sprites on the left and right 
sides of the screen. The section on "moving sprites" will also increase 
your understanding cf how sprite positioning works. 

SPRITE PRIORITIES 

You can actually make different sprites seem to move IK FRONT OF or 
BEHIND each other on the screen. This incredible three dimensional illu- 
sion is achieved by the built-in SPRITE PRIORITIES which d^lerrnine which 
sprites have priority over the others when 2 or more sprites OVERLAP on 
the Screen. 

The rule is "first come, first served" which means lower-numbered 
sprites AUTOMATICALLY have priority ever higher-numbered sprites. For 
exnmple J if you disploy sprite and sprite I so they overlap on the 
screen, sprite will appear to be IN FRONT OF sprite 1. Actually, sprite 
always supersedes all the other sprites because it's the lowest num- 
bered sprite. In comparison, sprite 1 has priority over sprites 2-7; sprite 
2 has priority over sprites 3-7, etc. Sprite 7 {the lost sprite) has LESS 
PRIORITY than any of the other sprites, and will always appear to be 
displayed "BEHIND" any other sorites which cverlup its position, 

To illustrate how priorities work, change lines 50, 60, and 70 in the 
program above to the following: 

EE1G •• Q) 
1 PRINT ■' T : y=53249 : F0RS=33ST0SS'5 ' POKES , 253 ■ NEXT 
20 FDRW*2040TO20<t2 : PQKEH . 13 : NEXT ■ 
361 P0kEV+2Lj? 

40 PDKEY+39* 1 : PQKEV+40 t 7 ■ P0KEV-+4 1 > 8 
50 P3KEV j 24 : PGKEV+l .-50 i F'OKEV+lSj @ 
m POKEV+3 , £4 ■ PQKEV+3 , so 
70 P0KEM+4 ■ 44 : POKEV+S , 70 

Yuu should sew u while sprile uri lop of a yellow spiite on Igp <jf un 
orange sprite. Of course, notv that you see how priorities work, you can 
also MOVE SPRITES and take advantage of these priorities in yuur ani- 
mation. 
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DRAWING A SPRITE 

Drawing a Commodore sprite is like coloring the empty spaces in a 
coloring book, bvery snrite consists- of tiny dots called pixels. To draw a 
sprite, alf you have tc dc is "color in" some of the pixels. 

Look at the spritemoking grid in Figure 3-6. This is what a blank sprite 
looks 'ike; 



2 6 3 1 

8 4 2 6 8 4 2 1 



2 6 3 1 

6 4 2 6 S 4 2 1 



2 6 3 1 
8 4 2 6 



4 2 1 



\Z .zt i n~ 



Figure 3-6. Sprite ma king grid, 

Each little "square" represents one pixel in the sprite. There are '2A pixel; 
□cross and 21 pixels up and down, oi 504 pixels in Ihe entire sprite. To 
make the sprite look like something, you hove to color in these pixels 
using o special PROGRAM . . but how can yoj control ever 500 indi- 
vidual pixels? That's where computer programming can help you. In- 
stead of typing 504 separate numbers, you only have To Type 63 num- 
bers for each sprite. Here's how it works . , . 
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CREATING A SPRITE . . . STEP BY STEP 

To make this as easy as possible for yoj r we've pjt together this 
simple step by step guide to help you draw your own iprnes. 

STEP I: 

Write the spritemaking program shown here ON A PIFCE OF PAPER . . . 
note that line 100 starts a special DATA section of your program which 
will contain the 63 numbers you need to ereors your sprite. 



[0 PRINT' rr ■FCfcr;-35£^ J 5'FOKE3rE:S:l,6 
28 V"S'32.:-S - PCKEV+34-, 3 

40 F0W=$TQ6* ; FEFIIiQ: PSKEbSSi M. G ; NCHT 
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STEP 2: 

Color in *he pixels on the spriternaking grid on Page ^2 (or use a piece 
of graph paper . . . reTiember. a sprite nas 24 square; across ard 21 
souares down). We suggest you use a p&nc I and draw lightly so you cor. 
reuse this grid, You tan create any imacje yuj like, t>ul for our example 

we'll draw ct simple box. 

STEP 3; 

Look at the first EIGHT pixels. Each column of pixels has a number (128, 
64, 32, 16, 8, 4, 2, I). The special type of addition we are going to 
shuw you is t; lype ol BINARY ARITHMETIC which Is used by most com- 
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puters ca a special woy of counting, Here's a close-up view of the first 
eight pixels in the top left hand corner of the sprites 



128 



64 



32 



16 



m 



STEP 4: 

Add up the numbers of the SOLID pixels. This first group of sight pixels 
is completely solid, so the total number is 255. 

STEP 5: 

Enter that rmrnher as the FIRST DATA STATEMENT in line 100 of the 
Spritemaking Program below. Enter 255 for the second and tuird group* 
of eight, 

STEP 6. 

Wok of the FIRST EIGHT PIXELS IN THE SECOND ROW of the sprite. Add 
up the values of the solid pixels. Since only one of Those pixels Is solid, 
the total value is 128. Enter th s as the first DATA number in line 101. 



128 


64 


32 


16 


8 


4 


2 


1 


! 

















STEP 7: 

Add up the values of the next group of eight p-xels (which is because 
they're all BLANK) and enter in line 1 01. Now move to the nex- group o~ 
pkels end repeat -he process for each GROUP OF EIGHT PIXELS (there 
are 3 g r oups across each row, and 21 rows). This will gme you a total of 
63 numbers. Each number represents ONE group of 8 pixel?, and 63 
groups of eight equals 504 total individual pixe s. Perhaps c better way 
of looking at the prog-am is like this . . . each line in the program 
represents ONE ROW in the sprite. Each of the 3 numbers n eoch row 
represents ONE GROUP OF EIGHT PIXELS. And each number tells the 
compute' which pixels to make SOLID and which pixels 1o leave blank. 
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STEP 8: 

CRUNCH YOUR PROGRAM INTO A SMALLER APACE BY RUNNING TO- 
GETHER ALL THE DATA STATEMENTS, AS SHOWN IN THE SAMPLE PRO- 
GRAM BELOW, Note That we asked you ro write your sprite program on 
a piece of paper. We did this for a good reason. The DATA STATEMENT 
LINES 100-120 in the program in STEP 1 ore only there to help you see 
which numbers relate to which groups of pixels in you" sprite. Your final 
program should be "crunched" like this; 



10- PRINT "d" ■'PDKE33280, 5 : P0KESSE81. S 

£8 w-53248 = POKEV+34 , 3 

3G P0KS33&K9 , 4 : POKE204S > 1 3 

40 FORN=GT0€2 ' REfiDQ : P0HES32*"H,C = NEWT 

l@e BflTrl233 , 2S!5, ?_55 , 1.33,0,. 1 , 128, B, i , 128-.fc*i,i 144; ©,1 

:Lj 144. 0,>1, 144.. 0, 1/ 144,3, 1 

til BRTR144.8, 1, 144, 6,1, 144,8, l,'I44»3tj 1,144,0,1 „ 

1.44,9, l,l£6,£r, 1, 120, 0,1 

ias DftTRi2s,g, 1,12s. e.i, 12s, 0,1, 120.0, i^ess, 235,^55 

290 ^200 : V= 1 SB ■ PQKES3252 , X ! PDKE53253., V 
MOVING YOUR SPRITE ON THE SCREEN 

Now thoT you've created your sprite, let's do scime interesting -things 
with It, To movs your sprite smoothly across trie screen, ade these two 
lines to your pracircm: 

50 POKE V+SjODiFOR X=24T0255:POKF. V+4.,X:NFiXT:POKE 

55 FOR X=0TO«:POKE Y+4,X:NEXT XiPOKE V+Tfi,0:GOTO 50 

LINE 50 POKEs the Y POSITION at 100 (try 50 or 229 Instead for 
variety). Then it sets up ct FOR , . , NEXT loop which POKEs the sprite 
into X position to X posin'on 255, in order. When it reaches the 255rh 
position, it POKEs the RIGHT X POSITION (POKE V+16,4) which s re- 
quired to trass lu I he riyrit side of the screen. 

LINE 55 has a FOR , , , NEXT loop which continues to POKE the sprite 
In the last 65 positions on the screen. Note that trie X value was reset -o 
zero but because you used the RIGHT X set-ing (PO<E V+16,2) X starts 
over on the right side of the screen. 

This line keeps going bock to itself (GOTO 50). If you just want the 
sprite to move ONCE across the screen and disappear, then take out 
GOTO50. 
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Here's o line which moves the sprite BACK AND FORTH: 

50 POKE V + 5,100:FQR X = 24TD255:POKE V*4,X=NEXT : POKE 

V + l(5,4 ; FOR X=0TO<S5; POKE V M,X; NEXT X 
55 FOR X=63TQ0 STEP-l:POKE V + 4,X:NEXT:POKE V+16,0- FOR 

X-255T024 STEP-1; POKE V+4,X;NEXT 
60 GOTO 50 



Do you See how these programs work? This progrcm is the same as the 
previous one, except when it reaches the end of the ricjht side uf the 
screen, it RbVfckSES IfStLF and goes back In the other direction. That is 
what the STEP— 1 accomplishes; ... it tells (he program to POKE ttie 
sprite into X values from 65 to'O on the right side of the screen, then 
from 255 to on the left side of the screen, STEPoincj backwards 
minus— 1 position at n timp. 

VERTICAL SCROLLING 

Th<s type of sprite movement s called "scrolling ." To scroll yccr sprite 
up or down in the Y position, you only have to use ONE LINE. ERASE 
LINES 50 and 55 by typing the lire numbers by -hemselves. and 



hitting 

50 < 
55 ( 



like this: 

) 
) 



Nov/ enter LINE 50 again as fol owe: 

50 POKE V-r-4,24<FOR Y=0TO255if>0KE V+5,Y!NEXT 

THE DANCING MOUSE— A SPRITE PROGRAM EXAMPLE 

Sometimes the technique* described in a programmer's refe-ence 
manual are difficult to understand, £0 we've pu* together a fun Sprite 
program called "Wichae J s Donaing Mouse," This program uses three 
differen: sprites in a cuts animation with sound effects — and to help 
you understand how it works we've included an explanation of EACH 
COMMAND so you con see exactly how the program is constructed- 
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5 £"54272 - P0K33+24 . E 5 : POKES, 220 ■ POKES+ 1 . 66 ■ PGKES+S, 

tS''P0K£3+6,2l5 

10 P0KES+7,126-P<0KES+S, IS3 POKES+12, 15 = FQKE3+ 13 , 21 5 



15 PRIHT"^' 1 :V=5324S-P0KEV»-2*-, 1 



P3KES1 , Ql-KEKT 
F'DKES2,S2:KEXT 
R0KES3,I33:KEKT 



J 31 

iZIi-iO mouse in" 



S3 f- QRS 1=122B8TQ12350 : 2EPHQ 1 
25 FQRS2=12332Tai24 i 4 : REP1BQ2 

30 FORS3=1241©T01247S: RERBQ3; 
35 POKEV+SS , IS! PQK EV--1 , 66 

43 PRINTTRB<lsej"rtI HM THE URH: 

43 P~192 

50 FQRS"fr=9TQ347STEP3 

55 RK*INT<^2E6 5 - LM«X-R1«»25S 

£9 POKEV,LW^PaKEV+l€jRX 

70 IFPssl32TH£NGO3UB20a 

75 IFF* 5 193THENGOSUF300 

S0 PCK£2e4@. P ■ FDRTa ] TOfia : hEXT 

§5 P=P+i: IFP;-i?4THENF-^lS'2 

90 NEXT 

r^s end 

100 EATflSS.e, i£@,S3,<B,252, 127, 129,254- 127. 123, 254 , 

1 27., 189, 254, 1 27 , 255 , 254 

LSI EflTfliSa. 255 252.3:! . 187.248, ^j 187, 132. 1,255, 128, 

3, 1SS, 132,1,331, 128,1,253.0 

102 EflTfIS £,£S5,0i 0.. 124,0,0, £34,0, J. -19?',- 32.3 131, 

224,7, 1. 192., 1,192,©, 2, IS2,G 

;103 EflTH3O,0, 12@, £3,0v252, 127, 123, 254, 127, 12?.. 25*!, 

127., 189.254. 127,255,254 

;[ 04 DFTHeS. 255 j £52. 3 1 . 221 , 248, 3 , 221 . 1 92. 1 , 255 , 1 2S , 

3,2j3, \3Z- 1,135. L28., 1,231,3 

105 ElfiTFlCH, 255,255.8. 124, B, 0,-254, S, J , 133,, K,7- 1, 123, 

? . 0, 204., : , 1 2S, 1 24 , 7, 128 , 56 

l@e Df=TF)30,3, 120, £3,13,252, 127, 129,254, 127,129,254, 

127,132,254,127.255,254 

] 07 DPTO63, 255 , 252, 31 . 223 ., 24S , 3 , 221 , 192, 1 , 255 ■ 1 34 , 

3. 133,2134, i, 133. 152, 1,255,43 

1 @3 DP.TR1 , 233 , £24 , 1 , £52 , 9, 3, 234 , 9 

109 DFTH7, 14,0,204, H, 9, £46,56. 0, 1:1.2, 1 12,0,9, C0,0, 

-1 

230 POKP5+4, 12? : POKES+4 , i 2S : RETURN 
390 =OKES+ L 1 , 12S P9'<ES+ 1 1 , 123 • RETURN 
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LINE Si 



5=54272 

POKES+24,15 
POKES,220 

POKES+1,68 
POKES+5,15 

POKES + 6,215 

LINE TO: 

POKES + 7,120 
POKES + 8,100 
POK.ES + 12,15 
PO ICES + 13,215 

LINE 15: 



Sets the variably S equal to 54272, which is the 
beginning memory location of the 5OUN0 CHIP. 
From now on, instead of poking a direct memory 
localion, we will POKE 5 plus a value. 
Same as POKE 54296,15 which sets VOLUME to 
highest level. 

Same as POKE 54272,220 which sets Low Fre- 
quency in Nfoke 1 for a note which approximates 
high C in Octave 6, 

Same as POKE 54273.68 which sets High Fre- 
quency in Voice 1 for a note which approximates 
high C in Octave 6. 

Sams as POKE 54277,15 which sots Attack/Decay 
for Voice 1 and in this case consists of the 
maximum DECAY level wUh no attack, which pro- 
duces the "echo" effect. 

Same as POKE 54278,215 which set* Sustain/ Re- 
lease for Voice 1 (215 represents a combination 
of sustain and release values). 



Same os POKE 54279,120 which sets the Low Fre- 
quency for Voice 2. 

Some a% POKE 54280,100 which sets the High 
Frequency for Voiie 2, 

Same as POKE 54284,15 which sets Altnclo'Decay 
for Volte 2 to same level as Voice 1 above. 
Same as POKE 54285,215. whirh sets Sustain/ Re- 
lease for Voice 2 to same level as Voice 1 above. 



PRINT" 

mi;h;;«:tj 
V=53248 



POKEV421J 



Clears the screen when the program begins. 

Defines the variable "V" os the starting location 

Df the VIC chip which controls sprites. From now 

on we will define sprits locations as V plus a 

value, 

Turns on (enables) sprite number 1. 
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LINE 20: 



FORSi = 122B3 
TO 12350 



READ Ql 



POKESl,Ql 



NEXT 



Wfe are going to use ONE SPRITE (sprite 0) In this 
animation, but we ure yuiny la USB THREE sets of 
sprite data to define three separate shapes. To 
gel our unirnuliuii, we will switch llie POINTERS 
for spnte to the three places in memory where 
we Irave stored the data which defines our three 
different thapes. The same iprite will he rede- 
fined rupidly over and over again as 3 different 
shape; to produce the dancing mouse nnimcition. 
You can define dozen: of iprite ahopes in DATA 
STATEMENTS, and rotate those shapes through 
one or more sprites. So you see, you don't have to 
limit one sprite to one shape or vice-versa. One 
sprite con hove many different shapes, limply by 
changing the POINTER SETTING FOR THAT 
SPRITE to different places in memory where the 
sprite data for different shapes h stored. This 
line means we have put the DATA for "sprits 
shape I" at memory locations 12288 to 12350. 

Reads 63 numbers in order from the DATA state- 
ments which begin at line 100. Ql is an arbitrary 
variable name. It tyuld jusl us cuiily be A, Zt or 
another numeric variable- 
Pokes the first number from the DATA statements 
(the first "Q1" is 30) into the first memory location 
(the first memory location is 12288). This is the 
some as POKE 12286 ,30. 

This tells the computer to look BETWFEN the FOR 
and NEXT parti of the loop and perform those 
in-between commands (HEADQ1 and POKES 1 ,Q1 
using the NEXT numbers in order). In other words, 
the NEXT statement makes the computer READ the 
NEXT Ql from the DATA STATEMENTS, which is 0, 
and also increments 51 by 1 to the next value, 
which is 12289. The result is POKE12289,0 . . . 
the NEXT command makes the loop keep going 
back until the last values in the series, which ere 
POKE 12350,0. 
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LINE 25; 



FORS2 = 12352 
TO 12414 



READQ2 



POKES2,Q2 

NEXT 
LINE 30: 



The second shape of sprite zero is defined by the 
DATA which ii located at locations 12352 to 
12414. NOTE thai location 12351 is SKIPPED . . . 
this is ihe 64th location which is used in the 
definition of the first sprite group but does riot 
contain any of the sprite data numbers. Just re- 
member when defining sprites in mnserutivp lo- 
cations that you will use 64 locations, but only 
POKE sprite data into the firsr 63 locations. 
Reads the 63 numbers which follow the numbers 

we used for the first sprite shape. This READ sim- 
ply looks for the very next number in the DATA 
area and starts reading 63 numbers, one at a 
time. 

Pokes the dgta (Q21 into the jnemory locations 
[52] For our second sprite shepe, which begins at 
locution 12352, 
Same use as line 30 above 



FOR53 — 12416 The third shape of sprite zero is defined by the 

TO 12478 DATA to be located at location! 12416 to 12478. 

READQ3 Reads last 63 numbers in orde' as 03. 

POKES3.Q3 Pokes those numbers into locations 12416 to 

12478. 
NEXT Same as lines 20 and 25. 

LINE 35: 

PQKEV + 3?, 15 5ets color for sprite to light grey. 

POKEV-H,6E Sets the upper right hand corner of the sprite 

square to vertical (Y) position 68. For the sake of 
comparison, position 30 is the top lefthand corner 
Y position on the viewing screen. 



170 



PROGRAMMING GRAPHICS 



LINE 40: 

PRINTTABIIAO) 



I AM THE 
DANCING 
MOUSE! 



Tabs 160 spaces from the top lefthand CHAR- 
ACTER SPACE on ihe screen, which is the some as 
4 rows beneath the clear command , , . this starts 
your PRINT message on the 6th line down on the 
screen. 

Hold down the ^^Q key and press the key 
marked | :' at the same time. If you do this 

inside quotation marks, a ''reversed E" will ap- 
pear. This sets the color To ever/thing FRINTed 
from then on Ic WHITE, 
This Is a simple PRINT statement. 



This sets the color back to light blue when the 
PRINT statement ends. Holding down Q and 
Q at th» same time inside quotation marks 
causv» a "reversed diamond symbol" to appear. 



LINE 45: 

P=I92 



Sets, the rarioble P equal to 192. This number 192 
is the pointer you must use, in this ease to "point" 
sprite to the memory locations that begin at lo- 
cation 12283. Changing this p«inter to the ioe«- 
ttons of the other two sprite shapes is the secret of 
using one sprite to erects an animation thot is 
actually three different shapes. 



LINE 50: 

FORX=0TO347 Steps the movement of your sprite 3 X positions at 

STEP3 a time (to provide fast movement) from position 

to position 347. 
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LINE 55: 

RX=INT(X/256) 



LX=X-RX + 256 



LINE 60: 

POKEV,LX 



POKhV+l6,RX 



LINE 70: 



RX is ihe Integer of X/256 which means, that RX is 
rounded off to when X is less than 256, and RX 
becomes 1 when X reaches position 256. We will 
ut* RX in a moment to POKE V+ 1 6 with a or 1 
to turn on the "RIGHT SIDE" of the screen. 
When 1he Sprite is at X position 0, the formula 
looks like this; LX = - (0 times 256] or 0. When 
the sprite is at X position 1 the formula looks like 
this: LX = T (0 times 256) or 1 . When the spiite 
is at X position 256 the formula looks Mice this: LX 
= 256 - (I times 256) Or which resets X back to 
which must be done when you start over on the 
RIGHT SIDE of the screen {POKEV+16,1), 



You POKE V b y itself with a value to set the Hori 
zontoi (X) Position of sprite on the screen, (See 
SPRITEMAKING CHART on Page 176). As shown 
ubovt; r the vulus of IX, which is the horizontal 
position of the sprite, changes from to 255 end 
when it reaches 255 it automatically resets back 
tc zero because of the LX equation set up in line 
5S. 

POKEV-M6 always turns on the "right side" of 
the screen beyond position 256, and resets the 
horizontal positioning coordinates to zero. RX is 
either a or a I based on the position of the 
sprite as determined by the RX formula in line 55, 



IFP-1P2THEN if the sprite pointer is set to 192 (the first sprite 

GOSLIB2C0 shape} the waveform control for th« first sound ef- 

fect is set to 129 and 128 per line 200. 
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LINE 75: 

IFP = 193THEN If the sprits pointer is sot to 193 (the second 

GOSUB300 sprite shape) the waveform control for the second 

sound effect (Voice 2) is set to 129 and 12B per 

Hue 300. 



LINE 80: 

POKE2040,P 



FORT=lTO60: 
NEXT 



Sets the SPRITE POINTER to location 192 (re- 
member P = 192 in line 45? Here's where we use 
the P). 

A simple time delay loop which sets the speed at 
which the mouse dances. (Try a faster or slower 
speed by Increasing/decreasing trie number 60.) 



LINE 65: 

P = P + 1 

IFP>1P4THEN 
P-192 



Now we increose the value of the pointer by odd 
ing 1 to the original value of P. 
Wc only want to point the sprite ro 3 memory lo- 
cations. 192 points to location!. 12288 1g 12350. 
193 points to locations 12352 to 12414, and 194 
points to locations 124 Id to 1247S. Thh line fells 
the computer to reset P back to 1 92 as soon as P 
becomes 1 95 so P never really becomes 195. P is 
192, 193, 194 and then resets back to 192 and 
the pointer winds up painting consecutively to the 
three sprite shapes in the three 64-byre groups of 
memory locations containing the DATA. 
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LINE 90: 

NEXTX 



LINE 95 
ENP 

LINES 100-109 

DATA 



After the sprite hqs become one of the 3 different 
shapes defined by the DATAj only then is it 
shewed to meve across the screen. It will jump 3 
X petitions at a time (instead of scrolling smoothly 
one position at a time, which is also possible). 
STEPping 3 positions at a time mokes the mouse 
"dance" faster across the screen. NEXT X matches 
the FOR. . X position loop in line 50. 



ENDs the program, which occurs when the sprite 
moves off the screen. 



The sprite shapes ere read From the data num- 
bers, in order. First the 63 numbers which com- 
prise sprite snapc 1 are react, then the 63 nuiri 
bers for sprite shape 2, and then sprile shape 3. 
This data is permanently read into the 3 memory 
lotuliqiii and after it is read into these locations, 
all the program has *a do is point sprite at the 
3 memory locations and the sprite automatically 
takes the shape of the data in those locations 
We are pointing the sprite at 3 tocations one at a 
time which produces the "animation" effect. If 
you want to see how these numbers affect each 
sprite. Try thonging the first 3 numbers in UNE 
100 1o 255, 255, 255. See the Section on defining 
sprite shapes For more information. 
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LINE 200: 

POKES +4, 129 
POKES +4, 128 
RETURN 

UNE 300: 



Waveform control set to 129 turns on the sound 

effect. 

Waveform control set to 128 turn* off the Sound 

effect. 

Sends ore-gram back to end of I ne 70 after 

waveform control settings are changed, to resume 

program 



POKES + 11,129 Waveform control set to 129 turns on ths Sourtd 

effect. 
POKES + 11,128 Waveform control set to 128 turns off the sound 

effect. 
RETURN Sends program bock to and of line 75 to resume. 
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EASY SPRITEMAKING CHART 





SfRiTt 


SPRITE 


SPWJE 


SPRITE 


SPRITE 


SPHITE 


SPRITE 


SPRITE 







1 


5 


3 


4 


S 


6 


7 


Turn en Sprire 


V+21 ,1 


V+21 ,2 


V+21 ,4 


V+21 6 


V + 21, 16 


V+21, is 


V+21 ,64 


V 1 21,12B 


Pul in Memory 


2040, 


20*1, 


2042, 


2043, 


2044, 


i0-1j. 


2046. 


5047, 


(3*1 Pginters> 


192 


193 


1*1 


1?5 


1*4 


1*7 


1*8 


1?9 


LocQTicms fpr 


1^188 


12552 


12416 


12480 


12544 


12108 


12672 


12736 


Sprite Piiel 


In 


•a 


to 


1o 


to to 


to 


"o 


(122SS-1Z79B) 


1Z350 


HMI4J 


124/B 


12542 


VitU> 126,'U 


12734 


12796 


Sprite Cctoi 1 


V+39,C 


V+4Q,C 


V+41X 


V+42.C 


V + 43.C |V+44,C 


V+4S.^ 


V+46.C 


Sat LFFT X 


V+G.X 


V+2.> 


V+4,X 


V+ D ,X 


V + 8.X V+10,X 


V+12.X 


V+14,X 


PwHten (II-SM) 
















Set ftlGHT X 


V+14,1 


V+li,2 


W-i-16,4 


v+is,s 


V+16,16 V+16,35 


i/+U,M 


V+ 16,128 


PosE+ien (ff— 2H| 


f+0,X 


V+2.X 


V+4,X 


V+6,X 


V+B.3C 


V-H0.3C 


1/+-12.X 


V+1-S,5i 


£er / PasiHsn 


l»|,» 


V+3.Y 


V+5,Y 


V+7,Y 


V +9,Y 


V+1J,Y 


V+13,f 


V+15,V 


Expand Sprrls 


V 1 29,1 


V 12?,2 


V+29,4 


V+25>,8 


V + 29,16 


V+29.C-2 


V+29A4 


V+29,129 


Hui iiunlu 1 IjvX 


















Expand Spriltr 


V+23,1 


V+23,2 


V+23,4 


V+23,8 


V4 23.16 


V+S3,C-2 


v' ■ 23, i4 


V+23,129 


^rticall/Y 


















Turn Or |Sbt) 


V+29,t 


V+28,2 


V+2B,4 


V+2B.8 


V + 28,16 


V+38,32 


V + 28,64 


V-r 28,128 


Multi-LolDT Mode 


















Multi-LoLar 1 


V+37,C 


V+37,C 


¥+37,C 


V+37.C 


V + 37.C 


V+37,C 


V+37,C 


V+37,C 


(Fifit Cttort 


















MLlti-Calor 2 


7+33;C 


V+33.C 


V+3B.C 


V+3B.C 


V+38.C 


V+38,C 


V+38X 


V+3B.C 


_S#- Priciriry 


lhi rnlp 
















is that Irwye - numfce 


red spnie 


» always liovt display Drioriy ever highe: 


of ?.iri**< 


rumb?ie 


d *prl*s. z rr wnrn| 


lift, sprits 


D has priority oyer ALL other ipritM. sorts 




~2 has ■■ 


at pn*r'ty. Thfe nn*ni 


ns Invv^r r 


umbeTed sprlt&s always eppear to move 




in frd!* 


r CF or ON TOP 


■ Kig^i^r t 


umrierpH ftprEtBS. 


Collision {Sprite 










to Sprit*} 


V+33 


IFPEEK(V+30>AW[> 


il^X THtr- 


[action] 


■Colliaicus (Sprire 










lg Bu^iYy i ttyiid) 


VI 01 


IF PEFJC(V I 31JAND 


S=X THEr- 


[ocfiofi] 
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SPRITEMAKING NOTES 



Alternative Sprite Memory Pointers and Memory Locations 
Using Cassette Buffer 



Put in Memory 


SPRITE 


SPRITE 1 


SPRITE 2 


If you're using 1 to 3 eprit&E 


(Set pointer,) 


2040.13 


2041,14 


2042,15 


yayj can use t^icse moTiory 
locations in the cassette 
buffer (832 to 1023) but 


Sprite Pi*el 


832 


896 


960 


Luiu Mum Tut 


IB 394 


tu 958 


lu 1C22 


for more then 3 spites we 


Blocki 13-1 5 








suggest using locations front 

12288 lo 12796 [see tkirl). 



TURNING ON SPRITES: 

Yen,' can tyri on any individual sprite by using POKE V— 21 and the 
number from the chart . , . BUT . . . turning on ju&t ONE sprite will turn 
OFF ary others. To tu-n on TWO OR MORE sprhes, ADD TOGETHER trie 
numbers of the sprites you want to turn on (Example: POKEV+2!, 6 turns 
un spiiles 1 und 2). Here is a method you can use ho lurr utie sp r ile ulT 
and on without affecting any of the others [Lief jl for animation). 

EXAMPLE: 

To turn off just sprite C type; POKE V + 21,PEEK Vf 21AWD(255- 1). 
Chnngethe nurrher 1 in (955-1.1 to 1,9,4,8,16,32,64, or 128 [for sprites 
— 7). To re-enable the ap'ite and not effect the other sprites currently 
turned on, POKE V+21, PEEK(V+21)CR 1 and change the OR 1 ro OR 2 
(sprite 2). OR 4 (sprite 3), etc. 

X POSITION VALUES BEYOND 255: 

X positions run from to 255 . . . and ihen START OVER from to 
255, To pot a sprite beyond X posifion 255 on the fee right side of *he 
screen, you mu 5 1 first POKE VI 16 as shown, THEN POKE a new X value 
from to 63, which will place "he sprite in rcne of the X positinns nt the 
"ight side of the screen. To get back tc positions C — 255, POKE V+16,0 
and POKE in an X ^alue from ro 255. 

Y POSITION VALUES: 

Y positions run from to 255, including to 49 of 1 the TOP of the 
viewing nren, 50 to 229 IN the viewing area, and 230 to 255 off the 
30TTO,Vi of the viewing crea. 
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SPRITE COLORS: 

Tc make sprite WHITE, type: POKE V + 39,1 (use COLOR POKE SFT- 
TING shown in chart, and INDIVIDUAL COLOR CODES shown below): 

— BLACK 4— PURPLE 8 ORANGE 12 -MED. GREY 

1— WHITE 5— GREEM 9 — BROWN 13— LT. GREEN 

2 — RED 6 — BLUE 10 — LT. RED 14 — LT. BLUE 

3— CYAN 7— YELLOW II— DARK GREY 15— LT. GREY 

MEMORY LOCATION: 

You must "reserve" a separate 64 EYTE BLOCK of numbers in the 
computer's memory for each sprite of whrch 63 BYTES wilf be used for 
sprite data. The memory settings shown below are recommended for 
the ''sprite pointer'' settings in the chart above Each sprite will be 
unique and you'll hcn/e to defii& it as you wish. ~o moke ell sprites 
exactly the sarne, point the sprites you wait to look the same to the 
.wms register For sprites. 

DIFFERENT SPRITE POINTER SETTINGS: 

These sprite pointer settings are RECOMMENDATIONS ONLY. 

Caution: you can set your sprite pointers anywhere in RAM memory 
but if you set them too "low" in memcry a long BASIC program may 
overwrite your sprite dcra, or vice versa. Tc protect an especially LONG 
BASIC PROGRAM from overwriting sp'ite data, you may wont to set the 
sprites at a higher area of memory (for example. 2040, 192 for sprite 
at locations T22B8 to 12350 . . . 2041,193 at locations 12352 to 12414 
for sprite 1 and so on ... by adjusting the memory locations from which 
sprites get -heir "dote/' you can define as many as 44 differen* sprites 
plus a sizable BASIC prcgram. To do this, define several sprite "shapes" 
in your UATA statements and then redefine a particular sprite by chang- 
ing the "pointer" so the sprite you are using is "pointed" at different 
areas of memory containing different sprite picture data. See the "Danc- 
ing Mouse" to see how this works. If you went two or more sprites to 
hciva THE SAME SHAPE [you car still change pnsition nna cnlnr nf each 
sprite), use the same sprite pointer ond memory location far the sprites 
you want to match (for example, vcl can pcint sprites and 1 to the 
same location by using POKE 2040,192 and POKE 2041, 192). 
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PRIORITY: 

P'iority means one sprite will appear to move "in front Or or "behind" 
another sprite on the cisplcy screen Sprites i/vith more p-iority always 
uopear to move "in front of" or "on top of" sprites with less priority. The 
rule is that Icwer numbered sprites hove priority over higher numbered 
ipriies. Sprile :ius piiuill} uver all other Spfilei. Sprite 7 I us no piiorily 
in relation to the other sprites. Sprite 1 has priority over sprites 2 — 7, etc. 
If ywj pyl two spriles in the same position, the sprite with the higher 
priority will appear IN FRONT OF -he sprte with the lower priority. The 
sprite with lower priority will either be obscured, or will "show through" 
{from "behind") the sprite with higher prority. 

USING MULTI-COLOR: 

You can create multi-colored sprite: although using "nulti-coior mode 
requires thnt ynir lisp PAIRS of oixels instead of ndividual pixels in your 
sprite picture (in other words each colored 'dot" or "block" in the sprite 
will rnnsisT of twrj pixels side by side). You have 4 colors to choose from; 
Sp-ite Color (chart above), Multi-Cobr 1, Multi-Color 2 and "Background 
Color' (backg.ro jnd Is achieved by using zero 5e~tings which let the 
background color "show through"). Consider one horizontal 8-pixel block 
in a sprite pictjre. The color of each PAIR of pixels is de ermined accord- 
ing to whether the left, right, or both pixels are solid, like this: 



r I I BACKGROUND (Making BOTH PIXELS BLANK [zero) lets the 
INNER SCREEN COLOR (background ) shew 
I trough.) 

MULTI-COLOR 1 (Making the RIGHT PIXEL SOL D in a pair of 
pixels seTS BOTH PIXELS to Multi-Color 1.) 

SPRITE COLOR (Making the LEFT PIXEL SOLID in a pair of pixels 
sets ROTH PIXFLS to Sprite Trior. ) 

MULTI-COLOR 1 (Making BO^H PIXELS SOLID in a pair of pixels 
sets BOTH PIXELS tc Multi-Colo' 2.) 
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Loot at The horimrffal 8-pixel row shown below. This block sets fho 
first two pixels to background color, the second two pixels to Multi-Color 
1, the Ihird tiA'o pixels To Sprite Cslnr and the fourth two pixels to Muiti- 
Color 2. The color oi each PAIR of pixels depends on which bils in 
euch pair are solid and which are blank, recording to the illustration 
above. After you determine which colors ycc wont in each pciir u" fjijieU, 
the nexl step is to add the values of 'he solid pixels in the R-pixel black, 
and POKE that numbs' into the proper rremory location. For example, if 
ihe B-pixeJ row shown below is the firsr bIoc< in a sprite which begins at 
memory locatian 832, the value of the solid pixels is 16— 8+2 + 1 — 27, 
so you would POKE 832,27. 



27 






16 - B 4 2 + 1 

22 | is | a 1 | i I i I 



i_ 



12 



LOO«S LIKE THIS in srnnr 

o 



BacKKflfllJND 

CO LOS 


i 


S'BITE 
r^nioH 


MUITIC'ILOR 



COLLISION: 

You can deect whether a spriiy I us Lullided with another spriTe by 
using this line: IF PEEK(V+30)ANDX=XTHEN [insert action hWj. 1 his line 
checks to see if a particular sprite has col ided with ANY OTHER SPRITE, 
where X equals I for sprite 0, 'I for sprite I, A for sprite 1, 8 for sprite 3, 
"6 for sprite 4, 32 for sprit* 5, 64 for sprite 6, and 123 fcr sprre 7. To 
check to see if the sprite has col ided with a "BACKGROUND CHAR- 
ACTER" use this iine: IF PEEK(V + 3l)ANDX = XTHEN [insert action here]. 
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USING GRAPHIC CHARACTERS IN DATA STATEMENTS 



The following program allows yoj 1o create a sprite using blanks and 
sjlid circles ( EiTSI O ' ' r DATA statements. The sprite and the num- 
bers POKEd into the sprite data registers are. displayed. 



10 -PRINT ■ tF ■ FQR1=0TQ63 :P0K3£. ! 32+I . : KENT 
29 SO9UB60aS0 
399 EKE 

seaas .erta" 
S@a@i ifith" 

69@B2 IRTFH" 
68003 rHTFT 
6OB04 DBTfl" 

69005 TATA" 
60S0S ERTfi" 
£0007 rfiTft" 
63063 JDrWR" 
£0009 IRTfl" 
69013 DHTR" 
£0011 EflTfi" 
IS00.1.2 IfiTrV' 
69013 EflTfi" 

60014 URTH" 

60015 EflTR" 
600 IS DRTfl" 
60017" IflTfi" 
6001 S IflTFT 

60019 IflTft" 

60020 HHTfl" 



******* 

«VM0MMMHMI 

*MMf« UHWWW 

**«*« ■ »!&* *«•* 
•Df»#* *«e *••** 

#»*** BHU** 

*i*#«* •** id »* ik* 
.•»••• •««»»« •• 
• tWilftiftttftH S 

A ***sft • 

* «** ill 

■iii' .«i«ii m 
m * ■ 
• • » 

60-180 V=53248 ■ P0KEV^2@@ : P0KEV+-1 ■ 130 : POKEV+21 > t : 

P.0KEv'+39, L4:PQKE20*0. 13 

60105 P0KEV+-23, 1 : P0KEV+29.. 1 

601 10 FQRIsSTO20 :.RERDfl* : POI?K=0TOr2 : T=0 < FORJ-S""07 : E=0 

60 1 40 IFMI D* CF1* . J-K*9+ 1 i 1 5 » " • " THP il ~ 1 

6OL50 T*T+B#et<7-J-S -HEXT^PRINTT; - PCKE03S+I*3-h:, T ! 

HEMT-- PRINT "-HB^T 

60200 RETURN 
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CHAPTER 



PROGRAMMING 

SOUND AND 

MUSIC ON YOUR 

COMMODORE 64 

■ Introduction 

Volume Control 

Frequencies of Sound Waves 
Using Multiple Voices 
Changing Waveforms 
The Envelope Generator 
Filtering i 

Advanced Techniques 
Synchronization and Ring 
' Modulation 



INTRODUCTION 

Your Commodore computer is equipped with on« of the moat sophisti- 
cated electronic must synthesizers available on any computer it comes 
complete with three voices, total y addressable, ATTACK/DECAY/ 
SUSTAIN/RELEASE (ADSR), filtering, modulation, and "white noisa/' All 
Off these capabilities ore directly available fcr you through a few ecsy to 
use BASIC anc/ar assembly language statements find functions. This 
means that you con make very complex sounds and songs using pro- 
grams That are relatively simple to design. 

This section of your Programmer's Reference Guide has been created 
to nelp van explore all the capabilities of the 6551 "SID" chip, the sound 
and music synthesizer inside your Commodore computer. We'll explain 
bulh the theory bshiltd musical ideas ond the prccticci aspects of turn- 
ing those ideas into real finished songs on your Commodore computer. 

You need not be an experienced programmer nor a music expert to 
nchieve exciting results from the music synthesizer. This section is full of 
programming examples with complete explanations to get you started. 

You get to the sound generator by PCHCE.ng into specified memory 
locations. A full list of the locations used is provided in Appendix O. We 
will go tnrough earn concept, step by step. By trie erval you should be 
ab e to create an almost infinite variety of sounds, and be ready to 
perform experiments with sound on your awn. 

Each sect'en of this chapter begins by giving you an example and a 
full line-by-line description of each program, wfich will show you how to 
use the characteristic being discussed. The technical exp anation is *or 
yuu tu reud whenever you are curious aboul whai is ox.iuu.Hy going uri. 

The workhorse of your sound programs is the POKE statement. POKE 
sets the indicated memory location (AflCM] equal tg a specified value. 
(NUM). 

POKE «Ei*,NUM 

The memory locations (MEM] used for rrusic synthesis start at 54272 
(ED400) in the Commodore 6^. The memory locations 54272 to 54296 
Inclusive are the POKE locations you need to remember when you're 
using the 6531 (SID) chip register mcp. Another way to use the locations 
above is to remember only location 54272 and then add a number from 
througn 24 to it. By doing this you can POKE all the locations from 
54272 to 54296 that you need from the SID chip, The numoers (MU/V.) 

184 PROGRAMMING SOUND AND MUSIC 



Thar you use In ycur POKE siatemeir must be between and 255, 
inclusive. 

When you've hed a lirrle more pracrice wirh making music, then you 
can get a little more involved, by using the PEEK function, PEEK is a 
function that is equal To the value currently in the indicated memory 
location. 

X = PEEK(MEM> 

The value of the variable X is set equal to the current cements of mem- 
ory location MEM. 

Of course, your programs include ulher BASIC commands, but for a 
full explanation of them, refer to the BASIC Statements section of this 
manual. 

Let's jump right in and try a simple program using only one of the 
three voices. Computer reudy? Type NEW, I hen lype in ifiis pray rum, 
□nd save it on your Commodore DATASSETTE 7 " 1 or disk. Then, RUN it. 

EXAMPLE PROGRAM 1: 



10 FaRL»sroS+24:PQKEU9 ; MEMT:R£M CLEFR SOUND CHIP 

28 F0KEB+5j 9 : POKEB-tfij 

30 F0KES*-24,13 : REM SET VOLUME TO 

riFM'iMun 

40 R£fTOMF,LF,IIR 
50 IFHF<eTHEHf£hD 

60 POKE£*i# HF : FC'KES, LF 

70 POKES+4,33 

3B FCRT= L TOUR ! NEXT 

90 F'CKES+1-,32 • FORT>=lTluT30 : NEXT 

i01 COTO40 

:. 13 EftTfiM* 177. 253. 28, 214.236 

12-3 zeiTfiZSfiTTi 233.23, 1??;236 

;.39 imnZS, 177. 123,, 26, 21 4.. 125 

1 48 BRTFI32, 94 , 758.. 25 , 1 77 , 250 

1 5(3 WTflSS, 21* - 250, 1? , S3.. 250 

1 60 BRTfll 9- 63 -- 250, 13 ,, S3 , 25£ 
1 70 OTTfffi 1 .. 13"- . 63 , 24 , &3 . 63 
1 86 BflTAfilj., 177 • 23Eb 2* j 63, 123 
190 TJRTRI3, 63, 250.-1,-1,-1 



Here's a line— by-line description of the prcyrurn you've just lyped in, 
Rafer to Ft whenever you feel the need to investigate parts of the pro- 
gram that you don't understand curipletely. 
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LINE-BY-LINE EXPLANATION OF EXAMPLE PROGRAM 1; 



Line(s) 



5 

10 

20 

30 

40 

50 

60 

70 

30 

90 

100 

110-180 

190 



Description 



Set S to start of 3ound chip. 

Clear all sound chip registers. 

Set Attack/Decay for voice 1 (A=0,D-=9). 

Ser Sustain/Release ^or voice 1 (5 = 0, R=Q) 

Set vol j tic at Ttaxiirnjir-, 

Reac high frequency, low frequency, durtrion of note. 

When high frequency loss than zero, sonc is over, 

Pake high and low freqjency 0" voice 1. 

Gate sawtooth waveform for voice I. 

Timing loop for deration nf note, 

Release sawteeth waveform for voice 1 . 

Return for next note. 

Data for iong: high Frequency, low frequency, duration 

(number of counts) fo r such rote. 

last nste of sang and negative Is signaling end of song. 



VOLUME CONTROL 

Chip register 24 contains the overall volume control. The volume ceri 
be set anywhere between and 15. The other four bits fire used for 
purposes we'll get into later. For now It is enough to know vohme is to 
15. Lack at Jine 30 to see how it's set In Example Program [ 

FREQUENCIES OF SOUND WAVES 

Sound is created by the movemenl of air in waves. Think of throwing 
o stone in+o a pool end seeing the waves radicte outwa'd, Wtien similar 
waves are created in ciir, we heci il, IT we measure "he time berw&en 
one peat of a wave and the next, we find 1he number of seconds tor 
one cycle of the wave (n = number of seconds). T he reciprocal of this 
numher [l/n) gives you the cycles per second. Cycle? per second ore 
more commonly known as the frequency. The highness or lowne&i of a 
sound (pitch) is determined by the frequency of the sound waves pro- 
duced. 

The sojnd generator n your Commodore computer uses two locations 
to determine the fpequern-y. Appendix E gives you the frequency values 
you need *o reproduce a full eight octaves nf musical notes. To create a 
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frequency other than the ones listed in the note table use "F C ut" (fre- 
quency output) and the following formula to represent the frequency (FJ 
cf the sound you want to create. Remember thcr each note requires 
both a high and a low frequency numbe'. 

F n - F OU ,/.06097 

Once you've figured cut what F n is far your "new" note the next step is 
to erects the high and low Frequency values for that note. To do this you 
must first round off F n so thut any numbers to the right af the decfmal 
point are eft eft. You are now left with an integer value. Now you can 
&etthe high frequency location (Ft,,) by using the formula F|-j = INT(F n /256) 
end the ow frecuency location |F (w ) shoulc be r^, 1 =F (I --C256*F w ). 

At this (juinr ygu have already pluyed wilh one voice uf yuur turnpe- 
ter. |f you wan _ ed to slop here you could f'nd a ccpy of you' favorite 
tune and become tie maestro conducting your own computer orchestra 
Fn your "at home" concert hell. 



USING MULTIPLE VOICES 

Yclt Commodore computer has three independently controlled voices 
(oscillators). Our First example program jscd only one- of them. Late' on, 
you'll learn how tc cnange the quality of the sound made by the voices. 
But right now, let's got oil three voices singing, 

This example program shows you one way to translate sheet music for 
your computer orchestro. Try typing it in, and 'hen SAVE it on your 
DATASSETTE™ or disk. Don't forget to type NEW before typing in this 
program. 

EXAMPLE PROGRAM 2: 

1G S=54272 ! FCiRL»STQS+24 ; F'CKEL, 8 : KEMT 
20 BIMH<:2.20©>, L<3> 20@J> *C«2, 2303 

30 DiMFaai; 

40 V<0> =17 ■ V Ci }=65 : V C 2;'=23 

56 POKESf IS t S : PDKES+22.. 1S8 : P0KES+S3 ■ 24 4 

&3 F OR I -0T 01 1 = REfiDFR C I > ; NEKT 

108 F0RK-6T02 

lie i-B 

120 RERDhFi 

133 IFHM=0THEN25B 

140 WH=V CK ) ■ WB=WF- 1 i FHM<0THEHNI'1=-Nfi ■ NR~0 : UB=3 

160 NT«rf1-12e*BRK-16#0CN 

176 FR=FQ(NT> 
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lSe IF0C>:=7THEN20t J 

130 FQRJ=6T00C!i5TEF-l : F3=FP/2 : HEX I 

£00 HFK*FIV256 ; LFK*FR-S5S*HFX 

21G IFDR^iTHENH^K.D-HFKXcK; t )=LFK : C<K, IJ*Wfl : 

1=1+1 G0T0129 

220 F0RJ=lT0ER";-l:H<K J I>=HF;:L:K,I?=LFr;'C<K,I?-Mf1 : 

1=1+1 NE4T 

230 H i K , I >*HFS : LCK . n =LF^ :C<Kj D «*IB 

240 1*1 tj : GOTO 120 

259 IFIMMTHEhtrt-1=I 

2S@ HEKT 

590 POKES<-5,9'PO<ES+6,240 

SIB P0KES+1£,85:PDKE5+13, 133 

523 FOKESflS, lB:PQKES+20, 13? 

530 POKES 1-24, 31 

549 F0RI=3TCin 

558 POKES, LOS , t > : POKES+7; U 1 , I > : FDKES+14..LC2, I i 

5SQ P0KESt-l,H<6< I5:F0KES+B>H<L D :PDKESH5,HC2, I> 

579 P0KES*'4,C<e,I>:'P0KE8*'lt/C<i J .I>:P0KESH8.G<£*D 

530 FUHT=1TC80: NEXT NEXT 

590 FOKTslTOSa^NEXr-POKEa+S^je 

S0tJ BflTft34;334j 36376, 39539^40830 

613 ERTfl4323S, 45330,43555,31443 

62S ERTA54502, 57743, SI L7S, 54314 

L000 DRTR5P4, 594, 594,596, 59fc 

1010 IIHTH1 S18 , 58?, 592 , 587, 585 ,'331. 336 

1 026 IlflTfil0Si7 i 333, 583 , 333, 3F5 , 587 . 587 

L 03G EFlTfll SSS, 333.. 33 1 , 337, 554 , 1534.- 593 

1540 IifiTfllGlS, 594.536,334, 532, 567 

1S53 EFITRl£iS,5£!7, 5855,331, 336,041,327 

13S0 IiflTH1507 

1399 1)H H« 

2030 DFI7R533, 533 , 333 , 533, 327 , 329 

2010 JDfi"m 51 1,583, 585, 578, 578,573 

2020 HR~R 136.. 190* 533,326- 578 

2030 EFTR32S, 327 , 329, 327- 329, 326, 578, 583 

204B DHTHisajg, 582,322,324,582,587 

2050 Bl=rfl329j 327, 1506, 583 

2060 IflTfl327. .323.537,331. SM 

ge?0 HflTH329>32e. 1505,573,834 

£099 Dfl T n324,322. 3£7,585. 1502 

299? DRTH0 

3803 IflTflb&.f'V.S&fci, 557,304, 306,3-08, 310 

3010 r.FlTfll591,5S7.311 i 318, 367 

3020 DflTflSeS, 304 , 299, 308; 

3930 ER7R304, 171 , LV'e^SQfij 231 .. 351 , 306, 308 

3Q40 8f!Tfl3l3^38e,313,3@S,295,2?7 293. 304 

3050 DRTFl 1586,562. 5£7,310, 315, 31 1 

'Mm UH"IH383,3I3, 297 

3073 DRTH158S,567,5S0,311,33S 

3060 DRTfl30S,309.30!>,3tr8 

3090 DflTRlS77,?33,235 J 3tie;,310,3K,304 

3106 DRTtf562, 546. 1575 

3999 BflTRB 
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Here h a line-by-line explanation of Example Program 2. For now, we 
are interested in how the three voices are controlled. 



LINE-BY4.INE EXPLANATION OF EXAMPLE PROGRAM 2. 



Lirtsfs) 



10 

20 

30 
40 
50 



60 

100 

TIC 

120 

130 

140 

150 
160 
]70 
180 
190 
200 

210 

220 

230 

240 
250 
260 
300 



Description 



Se- S equal to skirt of sound chip and clear all sound 

chip registers. 

Dimenson arrays to contain activity of song, 1/16-h of a 

measure per location. 

Dimension array to contain base frequency for each note. 

Store waveform control byte for each voice. 

Set high pulse width tor voice 2, 

Set high frequency for filler cu~off, 

Se1 resonance for filter and filter voice 3. 

Read : r base frequency for each note. 

Begin decoding loop for each voce. 

Initialire pointer to activity array. 

Read coded note. 

If coded note is zero, then next. voice. 

Set waveform controls ro proper voice. 

If silence, set waveform controls to 0. 

Decode duration and octave, 

Decode note. 

Get base frequency for (his note. 

If highest octave, skip division loop. 

Divide base frequency by 2 appropriate number of times, 

Get high and low frequency bytes. 

If sixteenth note, set activity array; high frequency, low 

frequency, and waveform control [voice oni. 

For all but las- beat of note, set activity ar-ay: high 

frequency,. lr>w frequRncy, wnvpfnrm control (voice on). 

For astbe.at of note,, set activity array: high frequency, 

low frequency, waveform con-rol (voice »ff% 

Increment pointer to activity array. Get next note. 

If longer Than before, reset number of activities. 

Go back tor next voice, 

Set Attack/Decay for voice l (A = 0, D=0). 

Set Sustain/Release for voice ' (S _ 15, R — 0), 
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Llne(s) 



310 

520 

530 
540 
550 
560 
570 
580 

590 

600-620 

1000-1999 

2000-299? 

3000-3999 



Description 



Set Attack/Decoy for voice 2 (A = 5, D=5). 

Set Sustain/Release for vclce 2 (S— 3, R— 5). 

Set Attar k/Ttecay for voice 3 (A = 0, D=10}. 

Set Sjstah/Re lease for voice 3 (S= 1 2, R — 5). 

Set volume \5, low-pass filtering. 

Start loop far every 1/I6th of c measure. 

POKE low frequency from activity array for ell vcic&s. 

POKE high frequency fruni activity array for all voices. 

PC) Kb- waveform control fronn activity array for all voices. 

Timing loop for l/l6th of a measure and buck for next 

l/l 6th m»cisure. 

Pause, then turn off volume. 

Bcse frequency data. 

Voice 1 data. 

Voice 2 da to. 

Voice 3 data. 



The values used in the data statements wore found by using the note 
table ir Appendix E and the chart belaw: 



NOTE TYPE 


DURATION 


1/16 


128 


1/8 


256 


DOTTED 1/8 


384 


1/4 


512 


1/4 + 1/16 


640 


DOTTED 1/4 


768 


1/2 


1024 


1/2+ 1/16 


1152 


1/2+1/8 


12S0 


DOTTED 1/2 


1536 


WHOLE 


2043 
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The note number from rhe note table Is added to the duration above. 
Then each nets can be ente-ed using only one nci-riber which is decoded 
by your program. This 15 any one method of coding note values. You 
may be able to come up with one with which you are nore comfortable. 
The ■formula used here for encoding a note is as follows: 

1} The duration (number of 1/l6ths of a measure) is mutiplied by 8. 
2) The result of step 1 is added to the octave you've chosen {0—7}. 
3} The result of step 2 is then mu'fiplied by 16. 

d) Add yojr rote choice CO- 1 1) to the result of the operation in slep 
3. 

In other words: 

((((D*8)-0) *l6) + N) 

Where D = duration, O = octave, and N = note 

A silence is obtained by using the negative of the djration rumber 
(number of 1/ ] 6-rhs of a measure * 128), 

CONTROLLING MULTIPLE VOICES 

Or.ce you hove gotten used to using more than one voice, you will fine 
that the timing of the three voices needs ts oe coordinated. This, is ac- 
complished in this program by: 

1) Divide each musical measure into 16 parrs. 

2) Store the even's that occur in each l,'16th measure "nterval in three 
separate arrays. 

The high anc low frequency bytes are calculated by dividing the fre- 
quencies of the highest octave by two (lines 180 and 190). The 
wuvefor'Ti control byle is a star! signal for beginning a note or continu- 
ing ci note that is already playing. It is a stop signnl to end a note. The 
waveform choice is mode once for each voice in line 40. 

Again, this is only one way to control multiple voices. You mny come 
up with your own methods. However, you should now be abe to take 
any piece of sheet music and figure out the notes for all three voices. 



PROGRAMMING SOUKD AND MUSJC 191 



CHANGING WAVEFORMS 

The tonal quality of a sound is called the finnbro. The timb'e of o 
sound is determined primarily by Its "waveform.'' If you remember the 
exarrple q~ throwing a pebole into the water Y CL know that the waves 
ripple evenly across the pond. These waves alnost lon!< lik*> the first 
sound wove we're going to talk about, the sinusoidal wave, or sire 
wave for short (shown below). 




Ir^ mnlrp what wVf tnlkma obfi jt <n hit mnre practical, let's go hack 
to the first example program to investigate different wave-orms. The 
reason for this s thai you rnn hear the nhnngps more ^nsily using only 
one voice. LOAD the first music program that you typec in earlier, from 
your DATASSETTE™ or disk, and RUN it again. That progrcm is using the 
sawtooth waveform (shown here) 




from the 658" SID chip's sound generating device. Try changing the note 
start number in line 70 from 33 -o 17 and the note stop number in line 90 
from 32 to 16. Your program should now look like this: 
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EXAMPLE PROGRAM 3 (EXAMPLE I MODIFIED): 

c; il:> 1=14-71 "3© 

1 F0RL"lTCS+24 - PCKEL - 3 ■ NEXT 

29 FOKES+Sj 9 ■ POKES+^j 
33 POKE'5+24,13 

40 KL'fllTHF J LF,IiP 

30 IFHFCBTHENEMD 

60 FDKE3+1 , HF ' F : '0 <E3 ,. LF 

76 PQKES+4; 17 

SO FOR - - HOUR next 

9B FOKES+4, 1£ F0aT=iTQ5a'NEXT 

1.00 00:043 

1 1 BflTfl25, 177 , 250 , 29 , 214, 250 

123 OT)Tfl25., 177,250,2$, t77 ,25(9 

13?i EflTR25, 177, L2S,2S, £14, 123 

1 43 EflTfiSS, 9«* , 750.- Z5, 1 T7 f £55 

159 DF1TR28,,214j25B, 19; 63,259 

163 EFITRlS^SS^Sa, 19, 63,250 

173 DflTfi21, 154,63,24,63,65 

;g© EftTF»25, 177, 258,24, S3, 125 

1 93 IiRTfl 1. 9, 63 , 250, -1,-1,-1 

Hr.vj RUN the program. 

Notice how the sojrtd quclity is different, less twangy, more hollow. 
That's because we changed the sawtooth waveform into c t'iangular 
waveform (show be law). 




The third musical wcw^form is called c variable pulse wave (shown 
below). 



■•-PULSE WIDTH 
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It i:- o rectangular wave and you determine the length of the pulse 
cycle by defining the proportion of the wave whicn will be Hgh. This is 
accomplished for voice 1 by using registers 2 and 3: Register 2 Is the low 
byte of the pulse width (L pw = through 255). Register 3 is the high 4 
bits (H DV , = through 15), 

Together these registers specify a J 2-bit number for your pulse width, 
which you can determine by using the following formula: 

PW„ = KU*256 I- l m 

The pulse width is determined by the following equation: 

PW 0Ut - (PW n /40.95) % 

When PW n has a value of 2048, it wil give you a square wove. That 
means thai register 2 (L»J = and regls-er 3 {H BW ) = 8. 
Now try adding this line to your program: 

15 POKES+3,8:POKES + 2,0 

Then change the start number in line 70 to 65 and the stop number in 
line 90 to 64, and RUN the program. Now change the high pulse width 
(register 3 in line 15) from en 8 to a 1. Nufice how dramatic the differ- 
ence in sound quality i»? 

The- last waveform available to you is white noise (shown here). 




It is used mostly for sound effects and sjch, To hear how it sounds, try 
changing the start numbe' In line 70 to 129 and the stop number in line 
90 to 123. 



UNDERSTANDING WAVEFORMS 

When a note is played, It consists of a sine wove oscillating at the 
fundamental frequency and the harmonics of that wave, 
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The fundamental frequency defines the overall pitch of rhe nore, 
Harmonics are sine waves having frequencies which are integer multi 
pies of the fundamental frequency. A sound wave is the fundamental 
frequency and all of the harmonics it takes to make up that sound. 



-RESULTAMTWAVE 

_ — RJNDAMitTAL (1ST HARMONIC 




2ND HAFW/GNIC 3RD HARMONIC 



In musical theory e1 J s say ihut the fundamental frequency is harmonic 
number l . The second horn-ionic has a frequercy twice the fundamental 
frequency, the thi.-d harmonic is three times the fundamental frequency, 
and so on. The amounts of each harmonic present in a note give ft its 

timbre. 

An acoustic instrument, like 3 guitar or a violin, has a very compli- 
cated harmonic structure. In fact, the harmonic Structure may vary as a 
single note is played. You have already playec with the waveforms 
available in your Commodore music synthesizer. Now let's talk about 
how the harmonics wr>rk with *he t'inngulor, sriwtnnth, and rectnnrjulnr 
waves. 

A triangular wave contains only edd harmonics. ~he amount of each 
harmonic present is proportional to the 'eciprocal of -he scuare of the 
harmonic number. In other words hcrmonie number 3 is l/9 quieter thar 
harmonic number ', because the harmonic 3 squared : s 9 (3 x 3) and 
the reciprocal of 9 is 1/9. 

As you can see, there is a similarity in shape of a tr angular wove to o 
sine wave oscillating at the fundamental frequency. 

Sawtooth waves contain ail the harmonics. The amount of each har 
monic present Is proporTioncI to the reciprocal of the harmonic number. 
For example, harmonic number 2 U 1/2 as loud as harmonic number " . 

The square wave rontoins odd ha'monics in proportion to -he recip- 
rocal of the harmonic number. Other rectangUar waves have varying 
harmonic content. By chang rg the pulse width, the timbre of T he sounc 
of a rectangular wove can be varied tremendously. 
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By choosing carefully the waveform used, you can start with a har- 
monic structure that looks somewhat Ike the sound yet want. To refine 
the sound, you car odd anothe' aspect of sound quality available on 
your Commodore 64 called filtering, which we'll dJ&cuss later in this 
section. 

THE ENVELOPE GENERATOR 

The volume of a musical tone charges from the moment yoJ first hear 
H, all the way through until it dies out and you can't hear it anymore. 
When a note is first struck, H rises from zero volume to \U peak volume. 
The rue at which this hupperrs is called the ATTACK. Then, it falls from 
the peak to some middle-ranged volume. The rale at which the fall o+ 
the note occurs is culled ihe DECAY. The mid-runged volume itself is, 
called the SUSTAIN level. And finally, when the nets Jtops playing, it 
falls from the SUSTAIN level to tero vulurie. The rate at which it falls is 
called the RELEASE. Here is a sketch of the four phases cf a note: 



5UB1 UN LbVEL- 



Each of the items mentioned cbove give certain qualities and restric- 
tions to a note. The bounds a r e rnlled pciromptRrs. 

The parameters ATTACK/DECAY/SUSTAIN/RELEASE end collectively 
rolled ADS3, can be rnitmlled by voir use of nnntner set of locoticrs in 
the sound generator chip. LOAD your first example program cgain. RUN 
it again and remember how it sounds. Then, fry changing line 20 so the 
program is like this: 
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EXAMPLE PROGRAM 4 (EXAMPLE 1 MODIFIED): 

5 8=54273 

IS F0RU*ST0S+a4 'POKEL, 8 ! NEXT 

2B P0KE3+5 , -?i? ■ POKES+b J 195 
38 P0KE3+S4, 15 

50 IFHF03THENEHD 

=8 PQKE3+1 j HF ■ & OKES , LF 
7@ POKES+4^33 

S3 FQRTMTOIW^NEKr 

00 POKES+4 , 32 : FORT* 1 TC30 : HEXT 
136 GOT04I3 

). 10 DRTA25J 1 77 , 25£i , 28, 214 , 250 
1 2© B flTB23 j 1 77 , 2!5P ., 2S . 1 77 .. 250 
L 30 BRTRSUj 177, 123 j 23 , 214 , 1 £5 
L48 liflTHSt.. 34,733.-25. 177,250 

1 S3 Bfrfl28, 214, 250 ..19. S3.. 250 
H6@ BflTRit, 63. 25ii, I9 t £&,%$& 
170 BFTH2J. , 154, 63, 24. 63, S3 
183 HHTH25.. 177, 250,24. 63, 125 

isa BfiTflisijSa.zsa.,-] ,-i ,-i 



Registers 5 ard 6 define the ADSR lor voice I, The ATTACK is the high 
nybbls of regls-er 5, Nybble is balf a byte, in other words the lower 4 or 
higher 4 ori/a!T locations (bits) in each register, DECAY is the low nybble. 
Yoj can pick any itumDer through 15 tor ATTACK, multiply it by 16 and 
odd to any number through 15 for DECAY. The values that correspond 
to these numbers are listed below. 

SUSTAIN level is the high nybble of regisler 6. It cun be through 15. 
It datines the proportion of the peak vof'jme that the SUSTAIN level will 
be. RELEASE .ale is Ihe law nybble of register 6. 
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Here ore the meanings of the values for ATTACK, DECAY, and RE- 
LEASE: 



WUE 


ATTACK RATE (TIME/CYCLE) 


DECAY/RELEASE RATE (TIME/CYCLE) 





2 ms 


6 ms 


1 


8 ms 


24 ms 


2 


T6 ms 


48 ms 


3 


24 ms 


72 ms 


4 


38 ms 


114 ms 


5 


56 ms 


168 ms 


6 


6B ms 


204 ms 


7 


80 mi 


240 ms 


8 


100 ms 


300 ms 


9 


250 ms 


750 ms 


10 


500 ms 


1.5 5 


Tl 


600 ms 


2.4 s 


12 


1 s 


3 s 


13 


3 £ 


9 s 


14 


5 5 


15 s 


15 


8 s 


24 s 



Here ere a few sample settings To Try fn your example program. Try 
these and a few cf your own. The variety of sounds you can produce is 
cistounding! For a violin type sound, try changing line 20 to read: 

20 PCHCES + 5,88:POICES + 6,89:REM A = 5;D = 8;S = 5;R = 9 

Change the wcweform to triangle and get a xylophone type sound by 
using these lines: 

20 POKE5+5,9;POKES + 6,9 : REM A=0;D=9;S=0;R=9 

70 POKES + 4,17 

90 POKES + 4.16: FORT-1TO50:NEXT 
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Change the waveform to square and try a piano type sound w'th these 
lines; 



15 POKES+3,8;POKES+2,0 

20 POKES+5,?:FOKE5+6,Q: REM A=0,-D=9,-S = 0;R = 

70 POKES+4,65 

90 PO<ES+4,«4:FORT = lTO50;NEXT 

The most exciting sound; are those unique to me music synthesizer 
itself, ores that do not attempt to mimic acoustic instruments. For 
example try: 



20 POKES I 5 J 144:POKES I 6,243:REM A=?;D=0; S=15;R=3 



FILTERING 

The harmonic content of a waveform can be changed by using a 
filter. The SID chip is equipped wrh (/nee types uf filtering. They can be 
used separately or in combination with one another. Let's go back to the 
sample program you've been using to play with a simple example lliul 
uses a filter. There are several filter control; to set. 

You add fine IS in the program to set the cutoff frequency of the filter. 
The cutoff frequency is the reference po nt tor the -liter. You SET the high 
ond low frequency cutoff points in registers 2? and 22. To turn ON the 
filter for voice 1, POKE register 23 

Next change line 30 to show that ci high-pass filter will oe used (see 
the SID register map). 
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EXAMPLE PROGRAM 5 (EXAMPLE 1 MODIFIED): 



3 3=54272 

1 9 FORL=3T0S+24 ; POKEL , S : HE*!T 

1 5 POKES+22, 129 : POKES+2 1,0: FOKES+23 > 1 

28 ?QKES+5, 3 ■ POKESh-C > B 

30 POKES+24-,79 

46 SEflDHF.LFMlr? 

30 IFHFOTHEHEHB 

68 POKES* l , HF ; POKESjLF 

79 FOKES-4j33 

00 FORT- iTQDR- NEXT 

90 FOKES+4, 32 ; F0RT=iTO5O ■ HEM 

Jf0 GOTO40 

lie OTTH25, 177,250,38,214.. 250 

120 DHTH25 . 1 77 , 350, 25, 1 77, 230 

13» DH7H2Sj IT - /, 125, 28, 214, 125 

140 DHTR32 , 94, 750 , 25, 177 , 35B 

15S BRTFt28, 214,250, 13, S3, 250 

160 BflTrU9,G3.,259, 19,63.253 

170 DRTR21 , 154, 63, 24, 63. 63 

180 BRTR25, L?7, 259- 24 ..€2, 125 

190 DRTRlS", 153,250, -1,-1,-1 



Try RUNnfng the program now. Notice The lower tones have had their 
volume cut down. It mokes the overall quality of the note sound tinny. 
This is because you ere using a high-pass filter which attenuates [cuts 
down the level of) frequencies below *he specified cutoff frequency. 

There are three types of filters in your Commodore computer's SID 
chip. W& hove been using the nigh-pass Filter. It will pass all the fre- 
quencies at or active the cutoff, while attenuating the frequencies belnw 
the cutoff. 




FREQUENCY 



The SID chip aha has a Cow-pass ff/ter, A3 its ncme implies, this fllle r 
will pass The frequencies below cutoff and attenuate those above. 
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FREQUENCY 



Finally, the chip is equipped with a bandpass filter, which passes a 
rarrow band of frequencies around the cutoff, and allenuutes oil 
ethers. 




FREQUENCY 



The nigh- and low-pass filters can be combined to form a notch reject 
filter which passes freqjencles awa/ from the cutoff while nttenuating 
at the cutoff frequency. 



FREQUENCY 
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Register 2J- determhes which type filter you want to use. This is in 
addrticn to reqisler 24's Function uj 1 hie overall volume control. Bit 6 
controls the high-pas; filter (0 = off, 1 = on), bit 5 is the bandpass 
filter, and bit 4 is file low-pass filter, The law 3 bits of the cutoff fre- 
quency are de-ermined by register 21 (L^) (L c( = through 7). While the 
8 bits of the high cutoff frequency are determined by reyisfer 22 (H cf ) 
(He = through 255). 

Through careful use of filtering, you can change the harmonic struc- 
ture of any waveform to get just the sound you want. In addition, chang- 
ing the filtering of a sound as it goes through the ADSR phases of its life 
can produce interesting effects. 

ADVANCED TECHNIQUES 

The SID rhip'e parameters can be changed eynamteally curing n nets 
or sound tc create many interesting and fun effects, 'n order 1o make 
this easy to do. digitized outputs from oscWaTor three and envelope 
generator three are available for you in registers 27 and 23, respec- 
tively. 

The output of oscillator 2 (register 27) is cirectly -elated to the 
waveform selected. If you chcose the sawtooth wavsforrn of oscillator 3, 
this register will present a series of numbers incremented [increased 
step by step) from lo 255 at a rate determined by the frequency of 
oscillator 3. If you choose the triangle waveform, the output will intre- 
ruerr from up lu 255, then decrement [decrease 5tep by step) back 
down to 0. If you choose *he pulse wave, the output will jump beck- 
crd-forth between and 255. Finally, choosirg the noise waveform will 
give you a se'ies of random numbers When oscillator 3 is used for 
modulation, you usoa ly do NOT want to hear its autaut. Setting bit 7 of 
register 24 turns -he audio output of voice 3 off. Register 27 always 
reflects the changing output of the oscillator and is not affected in any 
way by the envelope (ADSR) generator. 
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Register 25 gives you access to the output of the envelope generator 
of osrillntor 2. It functions in rriLcrn ihe same fashion that the output of 
oscillator 3 dees. The oscillator must be turned on to produce any output 
from this register. 

Vibrato {o rapid variation in frequency) con be achieved by adding 
the output o~ oscillator 3 to the frequency of another oscillator. Example 
Program 6 i lustratcs this idea. 

EXAMPLE PROGRAM 6: 



IB S=34272 

■£B FORL* BT024 ■ FOKES+L > ; NEWT 

30 P0KES+3-S 

40 POKES+5, 41 :P0KES*6,89 

50 POKES* 14* 117 

se pokes+iSj is 

70 P0KE3+24U43 

30 REflEFR;IiR 

30 IFFR-eTHENENIf 

180 POKES*-* » £5 

110 ~ORT«IT0DFW2 

1 E0 ^Q-FR-F'EEK < S-2?»S 

130 4F=>INTCFQ/2563 : _F=FBHMB235 

J 40 3QKES+3, LP : PQKES+ 1 . HF 

150 "4EXT 

150 =-QKE3+4,64 

170 3OTQS0 

506 DP>Tfl4ei7,£* 8 ;. 03, £ , 540? , £ 

5 J DRTHS5S3, 4 , 5407, 2 , 8583,. 4 

520 DHTH5407, 4 , S533, 12 , 9634.. 2 

5313 1IHTH 1 020? iZj 3.0S14 j 2i 85S3 j 2 

340 DflTftS634^44 10814* £, S583j2 

550 DRTR9634j4ji 8503, 12 

560 DRTflQj 6 



Here is a line-by-line explanation of Example Program 6; 
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LINE-BY-LINE EXPLANATION OF EXAMPLE PROGRAM 6: 



lincsls) 


Description 


10 


Se1 S to beginning a~ sound chip 




20 


C'ear all sojid chip locations. 




30 


Sel high pulse width for voice 1. 




40 


Set Attack/Decay for voice 1 {A=2, D=9). 
Set SustaiiVRelease for voics 1 (5=5, R = 9). 




50 


Set low frequency for voice 3, 




60 


Set triangle waveform for voice 3. 




70 


Set volume 15, tun o'f audio ourput of voice 


3. 


80 


Read frequency and duration of note 




90 


if frequency equals zerc, stop. 




100 


POKE start pulse waveform control voice 1. 




110 


Start timing loop for duration. 




120 


Get rew frequency using oscillator 3 output. 




130 


Get high and low frequency. 




140 


POKE high and low frequency for voice 1. 




150 


End of (iming loop. 




160 


POKE stop pulse waveform cant-ol voice 1. 




170 


Go back for next note. 




500-550 


Frequencies and durations fcr song. 




560 


2ero3 3ignal end of song. 





A wide variety of sound effects coi also oe achieved using dynamic 
effects. For example, the following siren prog rem dynamically changes 
the frequency output of oscillator 1 when it's oascd on the output cf 
oscillator 3's triangular wave: 
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EXAMPLE PROGRAM 7: 

10 3=54272 

20 F0RLmBTDS4 : FDKES+L.. : MEXT 

30 POKES+14,5 

40 PDKE5+18, ie 

3@ POKES Oi I 

&B POKES+24, 143 

70 ■P3KES+S.34S 

80 PQKES+4, SB 

30 FR=2389 

100 FORT=1TO200 

1.1 B FQ=FR+PEEK <S+£7>*3 . 5 

120 HF=IHTCFa<^£56> ; LF»FG-H=*356 

i 30 POKES+C , LF : POKES+ 1 , HI" 

14@ NEXT 

i^ri;i p:iKSS4v'4.,a 



Here is a line-by-line explanation of Example Program 7; 
LINE-Br-LINE EXPLANATION OF EXAMPLE PROGRAM 7: 



Linpfs) 


Description 


10 


Set S to start of sound chip. 


20 


Clear sound chip registe-s. 


30 


Set lew frequency of voice 3. 


40 


Sct triangjlar waveform voice 3. 


50 


Set high pulse width for voice I. 


40 


Set volume IS, turn off audio output o" voice 3. 


70 


Sel S'jslah/Relecise for voice 1 (3=15. R = 0). 


80 


POKE start pulse waveform control voice 1. 


n 


Set lowest frequency for siren, 


100 


Begin timing loop, 


no 


Ge1 new frequency using output of oscillator 3, 


120 


Get high and lew frequencies, 


130 


POKE high and low frequencies fo- voice 1 . 


140 


End timing loop. 


150 


Turn off volume. 
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The noise waveform can be used to provide a wide range of sound 
effecls. This example mimics a hnnd clap jsing a filtered noise 
waveform: 

EXAMPLE PROGRAM 3: 

1© £=54272 

20 FQWL-9T024 : PCKES+L..0 i NEXT 

30 Fi;iKE5+0, 240 i POKES+1 , 33 

46 P0KES+5,S 

S@ POKES+22* i@4 

60 POKES-* 23, i 

73 F'OKES+24,79 

SB FORM* 1 TO 1 5 

SB FCKES+4. 123 

100 FOfST" 1 ~O£S0 ■ NEXT ! POKES+4., 128 

1 l£i FCST:= 1 TOSS : HEXT = NEXT 

126 POKES+24,3 



Here is c line-oy-lins explanation of Example Program 8: 
LINE-MT-LINE EXPLANATION Of EXAMPLE PROGRAM 8: 



: ine(s) 


Description 


10 


Set S to start of sound chip. 


20 


Clear all sojnd ch'p registers, 


30 


Sot high and lew frequencies for voice 1. 


40 


Sei Attack/Decay for voice 1 (A— 0, D-8). 


50 


Se1 high cutoff frequency for filler. 


60 


Tum on fi ter for voice 1. 


/0 


Set volume 15, high-poss filter. 


30 


Count 15 claos. 


9Q 


Set srart noise waveform control. 


100 


Wait, lien sei stap riDise wave Form control. 


no 


Wail, then start next clap. 


120 


Turn o(T volume. 
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SYNCHRONIZATION AND 
RING MODULATION 

The £.581 SID chip lets you erects rrore complex harrronie struciLres 
through synchronisation or ring mpcfiila'iOT. 0" two voices. 

The process of synchronization is basically g logical ANDing of two 
wave forms. When either is ze'o. the output is zero. Tile following 
examp e uses this process to create on imitation or a mosquito: 

EXAMPLE PROGRAM 9: 



33 F0RL=STO24 ' POKES+L, @ : NEKT 

33 FOXES* l,l@e 

40 PCKES+5.,219 

30 POKES+ISj.28 

69 P0KES+24j \Z> 

78 FCKES+-4.. 19 

88 FOf?T»lTaS800'HEKT 

?0 POKES+4, 18 

180 FOF?T=-nOl@0S ' NEWT ■ POKES+24, 



Here is a line-by-l ne explanation af Example P-ogram 9: 
LINE- BY-LINE EXPLANATION OF EXAMPLE PROGRAM 9: 



Line(s) 


Deiurijjliun 




10 


Set S to start of sound chip. 




20 


Cle-nr sound chip register?;. 




30 


Set high frequency voice 1 . 




dO 


Set Attack/Decoy for vnice 1 (A=13, D = ll). 




50 


Set high frequency voice 3. 




SO 


Set volume 1 5. 




70 


Set star- triangle., sync waveform control for voice 


1. 


80 


Timing loop. 




CO 


Set stop triangle, sync wOvcforrr control tor voice 


1. 


100 


Wait., then -urn off volume. 





The synchronization feature is enabled {tjfned on} in line 70, where 
biTs 0,1, and 4 of register 4 are set. Bit 1 enables the syncing functlcr 
between voice 1 and voice 3. Bi*s and 4 have their usual functions of 
gn'ing voice 1 cine, setting the triangular waveform. 
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3ing modulation (cccomolished for voice 1 by setting b't 3 of register 
4 in line 70 of rhe program below) -eplnces the triangular output of 
oscillator 1 with a "ring moduiated" combination of oscillators 1 and 3. 
This produces non-harrrnnir overtone structures for use in mimicting bell 
or gong scLrds. Thia program produces a clock chime imitation; 

EXAMPLE PROGRAM 10: 






10 S=54£72 

Z® FORI =BTfl24 : F'CKES+L , 8 : NE'»:T 

3© POKES+li 133 

40 P0KE3+5< 9 

59 P0KES+I5-3S 

60 -■0KES-+-24, 15 

73 FORL=1T012:POKES+^.. 21 

@0 FQRT= 1 TO 1 000 NEXT : POKES***! , 

m TORTatToieee ■ next - next 



Here is a line-by-line explanation of Excmple Program 10- 












LINE-BY-LINE EXPLANATION OF EXAMPLE PROGRAM 10: 



Line(s) 


Description 


10 


Set S lQ sturt of syund chip. 




20 


Clear sound chip registers. 




30 


Set high frequency fcr voice 1. 




40 


Set Attack/Decay for voice 1 (A=0, D=9). 




5D 


Set high f'equency for voice 3, 




50 


Set volume 1 5. 




70 


Count numbe" of dings, set 3tart triangle, ring mod 




waveform control voice 1 , 




BO 


Timing loop, set stop tricngle, ring rrod. 




90 


Timing loop, next ding. 





The effects available through the use of the parameters of your 
Commodore 64's SiD chip are nurrefous and varied. Only through ex- 
peri mentcitiori nn you- own will you full/ apprBr Gte the capabilities of 

your machine. The examples in this section or The Programmer's Refer- 
ence Guide merely scratch the surfece. 

Watch for the book MAKING MUSIC ON YOUR COMMODORE COM- 
PUTER fcr everything from simple fun and gomes to proves sionai-rype 
musical instruction. 












208 



PROGRAMMING SO UN J AND MUilC 






CHAPTER 



BASIC TO 

MACHINE 

LANGUAGE 



• What Is Machine Language? 

• How Do You Write Machine 
Language Programs? 

1 Hexadecimal Notation 
Addressing Modes 
Indexing 
Subroutine* 
Useful Tips for the Beginner 

• Approaching a Large Task 

• MCS6510 Microprocessor Instruction 
'Set 

• Memory Management on the 
Commodore 64 
The KERNAL 

KERNAL Power-Up Activities 
Using Machine Language From 
BASIC 
Commodore 64 Memory Map 



WHAT IS MACHINE LANGUAGE? 

At the heart of every microcomputer, Si a cent'al microprocessor. It's 
a very special microchip which is the "b'oin" nf the computer. The 
Ccmmodore 64 is no exception. Every microprocessor understands its 
own language of instructions. These instructions are called machine lan- 
guage instructions. To put it more precisely, machine language is the 
ONLY programming language tha: your Commodore 64 understands. It 
is the NATIVE language of the machine. 

If machine language is the only language that the Commodore 64 
understands, then how does it understand the CBM BASIC programming 
language? CBM BASIC is NOT the machine language of the Commodore 
64. What, then, makes the Commocore 64 understand CBM BASiC in- 
structions like PRINT and GOTO? 

To answer this question, you must first see what happens inside your 
Commodore 64- Apar" from the micro srocessQi' which is the brain of the 
Commodore 6d, there h a machine language program which is stored in 
a special type of memory so tha - it can't be changed, And, more impor- 
tantly, it does noT disappear when The Commodore 64 is turred off, 

unlike a program that you may have written. This machine language 
orograrr is called the OPERATING SYSTEM of the Commodore 64. Your 
Commodore 64 knows whul lo do when it's turned on because its 
OPERATING SYSTEM (program) s automatically "RUN." 
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Thp OPERATING SYSTrM i-i in charge of "orgnni7ing" oil the memory 
in your machine for varous tasks. It also looks ct what characters you 
type on thp keyboard nnri puts them onto -he screen, plus a whole 
number of other functions. The OPERATING SYSTEM can be thought of 
as thf! "intelligence and personality" of the Commodore 64 (or any com- 
puter for that matter). So when you turn on your Commodore 6-4, the 
OPERATING SYSTEA1 takes control of your machine, and after it has 
done its Housework,, it then jays; 

READY. 



The OPERATING SYSTEA^ of the Commodore 64 "hen allows you to 
type on the keybourd, and use ihe built-in SCREEN EDiTOR on ihe Com- 
modore 64. The SCREEN EDITOR allows you to move the cursor, DELete, 
INSerl, elc , jnt is, in lact, only one part of the operating system that is 
built in fcr your convenience. 

All of the commands that are available in CESM BASIC are simply 
recognized by another huge machine language progrom built into your 
Commodore 64. This huge program "RUNs" the appropriate piece of 
machine language depending on which C3M BA5IC command is being 
executed. This program is called the BASIC INTERPRETER,, because it 
interprets each command, one by one, unless ir encemters a command 
it does not understand, and then the fomiliar message appears: 

?SYNTAX ERROR 
READY. 



WHAT DOES MACHINE CODE LOOK LIKE? 

You should be fcrnil'ar with the PEEK and POKE commands in the CBM 
BASIC language for changing memory locations. You've probably used 
them for graphics cr the screen, and fo' sound effects. Each memory 
location has its awn number which identifies it, This numoer is known as 
the "address" of a memory location. If you imagine the memory in the 
Commodore 64 as a street of buildings, then the number ot each doo' 
is, of course, the address, ^ow let's look at wvhicn parts of the street are 
used fur who! pui puses. 
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SIMPLE MEMORY MAP OF THE COMMODORE 64 



ADDRESS 


DESCRIPTION 


D 8. 1 


— 6b 10 Registers. 




2 


— Start of memory. 




Up to: 


— Memory used by -he operating system. 




1023 






1024 






up to: 


— Screen memory. 




2039 






2040 






up to: 


— SPRITE painters. 




2047 






2048 






up to: 


— This is YOUR memory. This is where yo 


ur BASIC ar 


40959 


mctliiie language prog 'am 5, or both, 


are stored. 


40960 






up to: 


— 8K CBM BASIC Interpreter . 




49151 






49152 






Up to: 


— Special programs RAM area. 




53247 






53248 






up t»; 


— VIC-II- 




53294 




■ 


54272 






up to: 


— SID Registers. 




55295 






55296 

up to; 


— Color RAM. 




56296 






56320 
up to: 
57343 


— \IO Registers. (6526's) 




57344 

Up tO: 

65535 

- 


— SK CBM KERNAL Operating System. 
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If you don't understand what the description of each part of memory 
means right now, this will become cl^ctr from other ports of this manua . 

Machine language prucruns consist of instructions which may or may 
not have operands (parameters) associated with them. Each instruction 
takes up one memory location, and any operand is contained in one or 
Two locations following the instruction. 

In your BASIC programs, words Ike PRINT and GOTO do, in fact, only 
take up one memory location, rather than one for each character of the 
word. The contents of the location that represents a particular BASIC 
keyword is called a toJcen In macine language, there are different 
tokens for different instructions, which clso take up just one byte (mem- 
ory location = byt?}_ 

Machine language instructions are very simple. Therefore, each indi- 
vidual instruction rrinncit Achieve fi great denl Mnrhine language in- 
struct ons either change the contents of a memory location, or change 
are of th^ 'ntemal registe's (special sTorage locaTinrs) inside the micro- 
processor. The Internal registers form the very basis of machine lan- 
guage. 



THE REGISTERS INSIDE THE 6510 MICROPROCESSOR 

THE ACCUMULATOR 

This is THE most important register in the microprocessor. Vurious ma- 
chine language instructions allow you to cooy the contents of o memory 
location into The accumulator, copy the contents of the accumula-or into 
a memory location, modify the contents of tie accumulator or same 
cither register directly, without affecfinc any rrernory. And tne ac- 
cumulator is the only register that has instructions fa' performing mnth. 

THE X INDEX REGISTER 

This is a very important 'egster. There are instructions for nearly all of 
the transformations ycc can mak« to "he accumulator, But Ihere ore 
other instructions for things thai only the X r egisfer can do. Various mo- 
chine Icinguoge instructions allow yoJ to copy the contents of c memory 
location ir to he X ityisler, copy llie cunlenls of the X register into a 
memory location, and modify the contents of the X, or some other regis 
te- directly. 
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THE Y INDEX REGISTER 

This is a very important register. Tiers arc instructions for nearly all ©f 
the transformations you can make to the accumulator, and the X regis- 
ter. But there are other instructions for things that only the Y register can 
do. Various machine language instructions allow you ta copy the con- 
tents of a memory location into the Y register, copy the contents of the Y 
register into a memory lacction, and modify rhe contents of The Y, or 
some other ■■eg stcr drectly. 

THE STATUS REGISTER 

This register consists of eight "flags" (a flag = something that indi- 
cates whethe - something has, ur lias nul occurred). 

THE PROGRAM COUNTER 

This contains the address of the current machine language instruction 
being executed. Since the operating system is always "RUN'Vng in the 
Commodore 64 (or, for that matter, any computer), the program counter 
is alwcys changing. It could only be stopped by halting the microproces- 
sor in some wuy, 

THE STACK POINTER 

This register contains the location of The first empty p ace on the s _ ack. 
The stack is used for "emporary storage by machine language pro- 
grams, and by the computer. 

THE INPUT/OUTPUT PORT 

This register eppea's at memory locations [for the DATA DIRECTION 
REGISTER) and 1 (for the actual PORT). It is an 8-bit inpLi'output port. 
On the fornmnonrs 64 this register Is used for memar/ management, to 
allow the chip To con'rol marc than 64K of RAM and ROM memory. 

The details of these registers are not gtven he-e. They are explained 
as *he principles needed to explain them are explained. 



HOW DO YOU WRITE MACHINE LAN- 
GUAGE PROGRAMS? 

Since machine language programs reside in memory, and there is no 
facility in your Commodore 64 for writing and editing machine language 
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prcgrons, y'OU must use either a program To do This, or write for yourself 
BAS ! C program that "allows" you To write mocHne language. 

The most common methods used to write machine langucge pro- 
grams are assembler p'ogams. These packages allow you to write ma- 
chine fanguage instructions in c standardized mnemonic format, which 
mokes The machine language program c lot mare readable thai a 
stream of numbers! Let's review: A program that allows you to write 
machine language programs in mnemonic format is called an assem- 
bler. Incidentally, a program that displays a machine langucge pro- 
gram in mnemonic format is celled o d/saisemb/e.-. Availob e for your 
Commodore 64- is a machine languuye moniloi curlridcje (will'i assem- 
ble'/ disassembler, etc.) made by Commodore: 

64MON 

The &4MON cartridge available from your local dealer, is a program 
thul ollawi yuu to escape from the world of CBM BASIC, into the land of 
machine language. It can display the content? of tie internal registers In 
the 6510 microprocessor, and it allows you to display portions of mem- 
ory, end chorge them on the screen, using the screen editor. It also has 
a built-in assembler and discssembler, as well as many other features 
that allow you to write nrd erirr machine anguage prograrrs easily. You 
don't HAVE to use an assembler to write machine language, but the tack 
is considerably easier with It. If you wish to write machine language 
programs, it fs strongly suggested lhat you purchase an assembler of 
some sort. Wifiout an assembler you will probably have to "POKE" the 
machine langucge program into memory, which is total y unadvisable. 
This manual will give its excrnples in the format that 64MON uses, from 
now on, Nearly all assembler to'imcts are the some, therefore the mo- 
chine unguucie examples shown will almost certainly be compatible 
with any assembler. But before explaining any of the other feature* of 
ci4MON, the hexudetimal numbering system must be explained. 



HEXADECIMAL NOTATION 

HeKodecimcjl notation Is used by most machine language program- 
mers when they telk about a number or address in ci machine : angi>ofje 
program. 

Some assemblers let you refer to addresses and numbers in decimal 
(base 10), binary (base 2), tr ever octal (base 8) as well as hexadeci- 
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mal (base 16) (or ]usr ' 'hex" as tiqet people say). These assemblers do 
the conversions for yov. 

HfixnneciTicil prnnnhl/ seems a little hard to grasp at first, but like 
most things, it won't take long to master with practice. 

By looking at decimal (base 10] numbers, you can see thot each digit 
fa! 3 jarrewhere in the range between zero and a number equal to the 
base less one (e.g., 9). THIS IS TRUE OF ALL NUMBER BASFS. Binary 
(base 2) numbers have digits ranging from zero tc one (which is one less 
then the base). Simi arly, hexadecimal nurrhers should nave digits 'ting- 
ing from zero to fifteen, but we do net have any single digit figures for 
the njmoers ten to fi^een, so the first six letters of th& alphabet a'e 
used instead: 



DECIMAL 


HEXADECIMAL 


BINARY 




1 




1 


ooooooco 

00000001 


2 


2 


000000 1C 


3 


3 


00000011 


4 


A 


ooaooioc 


5 


5 


00000101 


6 


6 


000001 10 


7 


7 


00300111 


8 


8 


00031000 


9 


9 


00301001 


10 


A 


0000 10 10 


1 1 


B 


00031011 


12 


C 


00001 too 


13 


D 


00031101 


14 


F 


00001110 


15 


F 


00001111 


16 


10 


0001 0000 
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Let's look ar ir another way; here's an example of how o base 10 
(decimal number) is constructed: 

Base raised by 

increasing powers ... 10^ 10' \Q l 10° 

Fqunls: 1000 100 10 1 



Consider 4569 (base 10) 4 5 6-9 

=(4xl000;- L (5X?00)+i;6XlC)+9 

Now look at an example of how a base 16 (hexudecinal number) is 
constructed: 

Base raised by 

increasing powers* ... 16 3 1 6 2 16 1 16° 

Equals; . 4096 256 16 1 

Consider 11 D9 (base 1(5) 1 1 D 9 

= 1 X 4096 + 1 X 256+ 13X16+9 

Therefore, 4569 (oase 10) = I ID9 (base 16) 

The range for addressab e memcy locations is 0-65535 (as was 
stated earlier). This range is therefore 0— FFFF in hexndecimol nntatinn. 

Usua'ly hexadecimal numbers are prefixed with a dollar sign (£), This 
is 1c distinguish them -from decimal numbers, let's loo< nt snnp "hex" 
numbers, using 64MON, by displaying 'he contents of seme memory by 
typing: 

SYS 8*4096 (or SYS 12*4096) 

B* 

PC SR AC XR YR SP 
.; 0401 32 04 5E 00 F6 (these may be different) 

Then if ycu type in: 

.M 0000 0020 (or,d press |^J|^| ). 

you will see rows of 9 hex nurrbers. The first 4-digit number ij the ad- 
dress of the first byte at memory being shown in mot row, and -he othef 
eight numbers are the actual contents of the memory locations begin- 
ning of that start address. 

You should really try to learn to "think" in hexadecimal. It's not too 
difficult, because you don't have to think about convert'ng it back into 
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decimal, For example, if you said that a porliculwt value is stored ct 
S14ED instead of 5357, ft shouldn't make any difference. 

YOUR FIRST MACHINE LANGUAGE INSTRUCTION 
LDA — LOAD THE ACCUMUIATOR 

tn 6£I0 assembly language, mnemonics are olways three characters. 
LDA represents "load accumulator with . . . ," and what the ac- 
cumulator should be loaded with is decided by the parameter^) asso- 
ciated with ihat instruction. The assembler knows which token is repre- 
sented by each mnemonic, and when It "assembles" on instruction, it 
simply puts into memory [art whatever address has been specified), the 
token, and what parameters, arc given, Some assemblers give error 
messages, or warnings when you try to assemble something that either 
the assembler, or the 6510 microprocessor, cannot do. 

If you pui u "#" symbol in front of the parame-er associated with the 
instruction, this means thot you want the register specified in the fnstrjc- 
tbn to be loaded with l ; ie "va ue" after the "#." For example: 



LDA #S05 -" C $ = hex 




(his "instruction will put $05 (decimal 5) into the occumulator register. 
The assenib er will put into the specified aodress for this instruction. $AV 
(which is the token for this particular instruction, in this mode)., and it will 
put £05 into the next location after the location cuifuining the instruction 
($A9). 

If the pcrameter to be used by an instruction has "#' before it; i.e., 
the parameter is a "value/' rather than the contents of a memory loca- 
tion, or another register, the instruction is said to be in the "immediate" 
mode. To put th is into perspective, let's compare this with another 
mode: 

If you WCinT to pJt The conrenrs of memory Irrntion $102E into the 
occumulator, you're using the "absolute" mode of instruction; 

LDA $!02E 

The ussembler con distinguish between the two different modes because 
tns latter does not have o "#" before the parameter. The 6510 micro- 
processor ccn dlstingjish between the immediate mode, and the abso- 
lute mode of the LDA instruction, because they have slightly different 
tokens. LDA {^mediate) has $A9 os it* token, and LDA [absolute), has 
$AD as its token. 
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The mnemonic representing an instruction usually implies what it 
does. For instance, if We consider another instruction, LDX, what co you 
think this docs? 

IT you said "load the X register with . . . ," go to the top of +he class. 
If you cidn't, then don't worry, learning machine language dues kjke 
patience, and cannot be learned in n day. 

The var'ous internal registers con be thought of as special merruiy 
locations, because they tea can hnld one byte of information. It is rot 
necessary for us 1o explain the binccy num serine system (base 2) since it 
follows, ihe same rules as outlined for hexnderirral and decimal outlined 
previously, but one "h'r" is one binary dig t and eight b its make jo one 
byfe! This means that the maxim unr number that can be contained in o 
byte is the largest lumber that an e ght digit binary number con be. ~hi3 
nurribe' is M 1 1 1 1 11 (birary), which equa.s $FF ^hexndsc'mnl), which 
equols 255 (decimal}. You have probably wondered why only numbers 
■from zero to 255 could be put into a memory location. If you try POICE 
7680,260 (which s a BASIC statement that "says": "Put the number two 
hundred and sixty. Into memory location seven thousand, six hundred 
and eighty," the BASIC interpreter knows that only numbers - 255 can 
be pul in a memory location ard your Commodore 64 will reply with: 

'ILLEGAL QUANTITY ERROR 
READY. 



If the limit of one bylc is $F : (hex), how is the address parameter 'r the 
absolute Instruction "LDA $102E" expressed in memory? It's expressed in 
two bytes (it jvon't fi1 into one, of course). The lower (rightmost) two 
digits of the hexadecimal acdress form the "low byte" of the address, 
and the upper (leftmost) two digits form the "high bytc.' f 

The 6510 requires any address to be specified with its low byte first, 
and then the nigh byte. This means that the instruction 'IDA $102E" is 
represented in memory by the three consecutive values: 

$AD, $2E r 510 

Mow ell you need to know is one more instruction and then you can w'ite 
your first program. Tut inslruclton is 3RK. Foi a full expluriullori uf ills 
rnstr^cticr, refer to M.O.S. 6502 Programming Manual, But rigit now, 
you can think cf it as the END instruction in machine Inngtage, 
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If we write a program with 64MQN r\6 put tine BRK instruction al the 
end, tien when the program h executed, it will return to 64MON when ir 
is finished. This might not happen if thprp is n mistake in /our program, 
or the BRK instruction is never reached (just like an END statement in 
BASIC may never get executed). This means that rf fhe Commodore 64 
didn't hove a STOP key, you wouldn't be able to abort your 3ASIC pro- 
grams! 



WRITING YOUR FIRST PROGRAM 

If you've used the POKE statement in BASIC to put characters ortc. the 
screen, you're oware that the charader codes for POKEing ore different 
from CBM ASCII characler vaiues. Foi example, if you enter: 



PRINT A5C;"A"] (and oress gSTTffil ) 

the Commodore 64 will respond with; 
65 
READY. 



However, to put an "A'' onto the screen by POKEing, the code Is 1, 
enter: 



HWi| MIJWMJH to clear the screen 



POKE 1M4,1 S P0KE o52?6,M [and §33BEJ| ) (1024 is the start 
of screen memory) 

The "P ,v in the POKE statement should now oe an "A. " 

Now let's try this in machine language. Type the following in 64A/.ON: 
(Your cursor should be flashing alongside a "." right now.) 

.A 14DD LDA #501 (and press JJ^^J ) 
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The Commodce 64 w II prompt you with: 

,A 1400 A9 OT LDA #$0! 

.A 1402 ■ 

Type: 

.A 1402 STA $0400 

(~he STA instruction stores the contents of the accumulotDr in a specified 
memory location.) 

The Commodore 64 will prompt you with: 

.A 1405 ■ 

Now type in; 

,A 1405 LDA #$GE 
.A 1407 STA $D800 
.A 140A BRK 

Clecr the screen, and type: 

G 1400 

The G should turn into an "A" if you've done everytning correctly, 

You have now written your first machine language progmm. l-s pur- 
pose is to store one character {"A") at the first location in the screen 
memory. Havinc achieved This, we must now explore some of the oti&r 
instructions, and principles. 

ADDRESSING MODES 

ZERO PAGE 

As shown earlier, absolute addresses are expressed ii terms of a high 
aid a low order byte. The high order byte is often referred tu as ihe 
page of memory. For exomple. the address $1637 is in page t!6 (22), 
and $0277 is in page $02 (2), There is, however, a special mode of 
addressing known as zero page addressing cine is, as the name implies, 
associated with the addressing of memory locations in page zero. These 

BASIC TO MACHINE LANGUAGE 221 



addresses, therefcre, ALWAYS have a high order byte of zero. The zero 
poge mode of addressing only expects, one byte to describe the ad- 
dress, rather than two wnen using or absolute address. The zero page 
addressing mode Tells the microprocessor ro nssume That trie high order 
address is zero. Therefore zerc page addressing can reference memory 
locations whose addresses are between SOOOO and SOOFF. This may not 
seem too important at a he moTient, but yo'/ll need +hc principles of zero 
page addressing soon. 

THE STACK 

The 6510 microprocessor has what is known as a stack. This s used 
by both the orngrammer ard the microprocessor 1c. term pirn 'ily re- 
member things, and to remember, for example, an order of events. The 
G05UB statement in BASIC, which allows the programmer to call a sub- 
routine, mus- remember where it is being called from, so that when the 
RETURN statement is executed in the subroutine, the BASIC interpreter 
"knows" where to go back to continue executing. When a GOSU3 
statement is encountered in a program by the BASIC interpreter, the 
BASIC interpreter "pushes" its CLrre-it position crto the stack before 
guincj to du the subrouline, aid when o RETURN is executed, the in- 
terpreter "puis" oft the stock the informcrticr that tells it where it was 
before the subroutine call was made. Tie interpreter uses instructions 
like PHA, which pushes tne contents of The accumulator onto Th& stock, 
and PLA (the reverse) which pulls a value off the stack and into the 
accumulator. The status register con also be pushed and pulled with tne 
PHP and PLP, respectively. 

The stark is ?.5fi bytes Irsrg, and "s orated "r poge ere. of memory. It 
is Therefore from $0100 to $0"FF. It is organized oackwords in memory. 
In crher wards, the first positlan in the stack is at S01FF, and the lasT is 
at 30100. Another register in the 6510 microprocessor is col ed the stack 
primer, and ir always points to tt3 next availoble IcccTion in The stack. 
When somcthirg Is pushed onto the stack, it is placed where the stack 
pointer points to, and the s~ack pointer "s moved down to the next posi- 
tion (decremented). When something is pulled off the stock, the stack 
puinler is ricrerneriied, mid the byle puinled ta by the stack pointer is 
placed Into the specified register. 
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Up ta this point, we have covered immediate, zera page, and abso- 
lute mode instructions. Ws have .also covered, but hove not redly talked 
□bout, the "implied" mode. The implied mode Trteons that information is 
implied by an instruction itself. In other words, what registers, flog", 
and memory ihe inslrucfion is referring to. The examples we have seen 
are PHA, PLA, PHP, and PLP, which refer to stack processing and the 
aceumulcrto- and status registers, respectively. 



NOTE: T|- e K register we'll be referred to as X frorr now on, orid similarfy A (ac- 
cumulator), Y <Y index regijter), S (stack pc?ntflrr, arid P (processor &"clua). 



INDEXING 

Indexing plays an extremely important port in the running of the 65 10 
microprocessor. It can be defined as "r'ea-inrj an actual address from a 
base address plus the contents of either the X or Y index registers." 

For example, if X contains $05, and the microprocessor executes an 
LDA instruction in the "absolute X indexed mode" with base address 
(e.g., $9000). then the actual location rhat is loaded into the A register 
is S°000 + $05 - $9005. The mnemonc format of an absolute indexed 
instructicn is the same as an absolute ir struction except a "X" or ",Y" 
denoting the index is added to the address. 

EXAMPLE: 

IDA £?0OO,X 

"here are absolute indexed, zero page ndexed, indirttl indexed, 
and indexed indirect modes of addressing available on tne 6510 
microprocessor. 

INDIRECT INDEXED 

This only allows usage of the Y register as the index. The actual ad- 
dress can on V be in iero page, and the mode of instruction is cnlled 
Indirect because the zc-o page address specified in the rnstrjerion con- 
tains the low byte of "he actual eddress, and the next byte to it contains 
the high order byte. 
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EXAMPLE-. 

Let us suppose that location }02 contains $45, and location $03 con- 
tains $1E. If the instruction to load the accumulator in the indirect inde- 
xed mode is executed and the specified zero page address is $02, then 
the actual addre« will be: 

Low order — contents of $02 
High order — contents of $03 
Y registe' =$00 

Thus the actual address = 41E45 + Y - $1E45. 

The title of this mode doe; in feet imply an indirect principle, although 
this may be difficult to grasp at first sight. Let's look ct it another way: 

J l am going to deliver this letter to llie posl of fit*; ut uddress 
$02, MEMORY Sf., and the address on the letter is $05 houses past 
$1600, MEMORY streel." This is equivalent to the code: 

LDA #$00 — load low order actual base address 

STA $02 — set the low byte of the indirect address 

LDA #$16 — load high order indirect address 

STA $03 — set the high byte of the indirect address 

LDY #$05 — set the indirect index (Y) 

LDA {S02),Y — load indirectly indexed by r 

INDEXED INDIRECT 

Indexed indireul only ullows usuge of the X register as the index. This 
is the same as indirect indexed, excep- it is the zero page address of the 
puiflfer thai is indexed, rather than the actual base address. Therefore, 
1he actual hase address 15 the actual address because the index hat 
already been used for the indirect. Index indirect would also be used if 
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a table of indirect pointers were laccted in ze-o page memory, and the 
X register could then specify which indi'ecl pointer to use. 

EXAMPLE: 

Let us suppose that locaton $02 contairs $45, and locafon $03 con- 
tains $ 1 0. If the instruction to load the arnimulnlnr in the indexed indi- 
rect mode is executed aid the specified zero page address Is $02, then 
the actual add 'ess will be: 

Low order = contents of ($02 + X) 
High order = contents of ($03 + X) 
X register = $00 

Thus the actual pointer is in — $02 + X = $02. 

Therefore, the actual address is the indirect address contained in $02 
which is ggziin $1045, 

The title of this mode does in fact imply the principle, plthctgh it may 
be difficult to grasp at first sight. Look at it this way: 

"I am go rg to deliver this letter to the fourth pest office at address 
$01 ..MEMORY ST., and the address on the letter will then be delivered to 
$1600, MEMORY street." This is eqjivalent to the code: 

LDA #S00 — load low order actual base address 

STA $0$ — set the low byte of the indirect address 

LDA #$16 — load high order indirect address 

STA $07 — set the high byte of the indirect address 

LDX #$05 — set the indirect index (X) 

LDA ($02,X) — load indirectly indexed by X 



NOTE: Of "h& twe indirect pn»thodt &f addressing, thg first (indirect indexed) is J cr 
more widely used. 



BASIC TO MACHINE LANGUAGE 525 



BRANCHES AND TESTING 

Another very important principle in machire language is the ability to 
test, and deteU certain conditions, in o smiliar fashion to the "IF . . . 
1HEN, JF . . . GOTO" structure in CBM EASiC. 

The various tlcicjs in the status register are effected by different in- 
structions in differenl '.ways. For example, there is a fag that is set when 
an instruction has caused o ieru reaull, und is resel when u result is net 
zero. The instruction: 

LDA #$00 

will cause '-he zero resi/it flag to be set, because the instruction has 
resulted in the accumulntor containing a 7ero. 

There ore o set of instructions that will, given a particula" condition, 
hrranrh t<-. nnnther part of the program. An example of c branch instruc- 
tion is BEQ, which meens Branch if result EQuot to zero. The branch 
instruction.; brnrch if the condition is true, md if nol, the program con- 
tinues onto the next instruction, os if nothing hac occurred. The branch 
instructions brench not by the result o* the previous instrucfion(s), but by 
internally examining the status register. As was just mentioned; there is 
a zero result flag in the status register. The BEQ instruction branches if 
the zero result flog (known as Z) is set. Every branch instruction has an 
opposite branch instruction. The BEQ instruction hes an opposite instruc- 
tion BNE, wh'ch means Srcncfi or result Wot Fquaf to zero (i.e., 2 net 
set). 

The index registers have a number of associated instructions whin 

modify their contents. For exurnple, (he INK instruction FNcrenrenfs fne X 

index register. If the X register contained $Ff- before it was incremented 
(the maximum number tne X register can contain), it will "wrap around" 
back to zero. I f you wented a program to continue to do something until 
you T^d performed the increment of the X index that pushed it around 
to zero, you could use the BNE instruction to cemtnue "looping" around, 
until X became zero. 

The reverse of I NX, is DEX, which is DFtremenf the X index register. If 
the X index registe- is zero, DEX wraps around to $FF. Similarly, there 
are INV and DEY fo' the Y index register. 
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But what if a program didn't want to wait until X or Y had reached (or 
not reached) zero? Well there are comparison instructions, CPX and 
CPY, which allow the machine language programmer to test the index 
registers with sperjf c values, or even the contents of memory locanoi>, 
If you wanted to see if the X register contained $40, you would use the 
instructicr; 

CPX #$4.0 — compare X with the "value" $40. 
BEQ — branch to somewhere else in the 

(some other program, if this conHiti nn is "true," 

part of the 
program) 



The compart;, and branch instruction* play a major part In cny machine 
language program. 

The operand specified in a branch instruction when using 64MON is 
the address of the part of the program that the branch goes to when the 
proper conditions are met. However, the operand is only an offset, 
which gets yau frcm where the program currently is to the eddress spec- 
ified. This offset is just one byte, and therefore the range that a brarch 
instruction can branch to is limited. It enn branch from 1?S bytes back- 
ward, to 127 bytes forward. 



NOTE; Thit it a total range cf 255 by**s which ii, ot coLrsw, tne maMnum rangt of 
values one byfe "an contain. 



64AAOM will tell you if you "branch out of range" by refusing to "as- 
semble" thnt pnrticLilrir instruction. But don't worry about that now be- 
cause it's unlikely that you will have such branches for quite a while. The 
branch is a 'quick" instruction by machine anguage standards because 
of the "offset" principle as opposed to an absolute address, 64MON 
allows you to type in un ubsolule add eis, aid it ccilculules "lie correct 
offset. This s just one of the "comforts'' of using an assembler. 



NOTE; '* ^ rJOT possible to rnver every single branch instruction. For turther inrarma- 
rion, refer to the Bibliography section in ApppnrJl* F. 
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SUBROUTINES 

In machine language (in the snrne way as using BASIC), you con call 
subroutines. The instruction to call o subroutine is JSR (Jump to Sub- 
Routine}, followed by the specified nhsolute cddress. 

Incorporated in the operoling 3ystem, there is a machine language 
subroutine that will PRINT a character ro the screen. Ihe CBM ASCII 
code of the character should be in the accumulator before colling the 
subroutine. The address of this subroutine is $FFD2, 

Therefore, to print "HI" to the screen, the following program should 
be entered: 



,A 1400 LDA #$48 — load the CBM ASCII code of "H" 

.A 1402 JSR SFFD2 — print it 

.A 1405 LDA #$49 — load the CBM ASCII code of "\" 

■ A 1407 JSR &FFD2 — print thot too 

.A 140A LDA #$0D — print a carriage return as well 

.A 140C JSR $FFD2 

.A I40F BRK — return to 64MON 

■ <3 1400 — will print "HI" and return to 64MON 



The "PRINT a character" routine we have just used is part of ihe 
KERNAL jump table. The instrjrrinn similnr to GOTO in BASIC Is JMP, 
which means JuMP to the specified absolute address. The KERNAL is a 
long list of "srandardizec' suorourfrtes that control ALL input and output 
of the Commodore 64. Each entry in the KERNAL JAAPs to a subroutine in 
the operating system, This "jump table" is found between memory locft- 
tians $FFSM to $FFF5 in tie operating system. A full explanation of the 
KERNAL is available in the "KERNAL Reference Section" of ttis manual. 
However, certain routines are used here to show how easy and effective 
the KERNAL is. 

Let's tow use the new principles you've fust learned in another pro- 
grain. It will help you to put ihe inslrucligns inlu context: 
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Tin Is program will driplcy the alphabe* using a KERNAL routine. The 
only isia' instruclion inl reduced here is TXA Transfer the contents of the X 
index register,, info the Accumulator. 

.A 1400 LDX #$41 — X = CBM ASCII of "A" 

,A 1402 TXA — A - X 

.A 1403 JSR 5FFD2 — print character 

.A 1406 I NX — hump count 

.A 1407 CPX #S5B — heve we gone pa;1 "Z" 1 

.A 1409 BNE ^1402 — no, go bad and do more 

A 140B BRK — y« return to 64MON 

To see the Commodore 64 print tne alphabet, type the -amiliar com- 
mend: 

.G 1400 

'he comments that are beside the program, exploh The program flow 
and logic. If you are writing a program, write it on paper first, and then 
test it in small parts if possible. 



USEFUL TIPS FOR THE BEGINNER 

One of the best ways to learn machine language is to look at other 
peoples' machine language programs. These are published all the time 
ill magazines and newsletters. Look at them even if the article is for a 
different compu'er, which also uses the 6510 (or 6502) microprocessor. 
You should make sure that you tnaroughly understand the code that you 
look at. This will require perseverance, esoecially wien you see a new 
Technique that you have never come across before. This ccn be infuriaT- 
ing, but if patience prcva 'Is, you will be the victor. 

Having looked at other machine language programs, ynu MUST write 
your own. These may be utilities "or your BASIC programs, or they may 
be an all machine language program. 
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You should clso Use the utilities that are available, either IN your 
computer, or in a program, thct aid you in writing, editing, or tracking 
down errors in a machine language program. An example would be the 
KERNAL, which allows you to check the keyboard, print text, control 
peripheral devices like disk drives, printers, modems, etc., mnnnge 
memory and the screen. It is extremely powerful and ft 15 advised 
strongly that it is used (refer to KFRNAI section. Page 26S). 

Advantages of writing programs in machine language. 

1. Speed — Machine language is hundreds, and in some case* 
thousands of times faster than a high level unyuuye such as 
BASIC 

2. Tightness — A machine language program can be made totally 
"watertight," i.e., the user con he mode tc do OMLY what the 
program allows, and no more. With a high level language, you 
are relying on the user not "crashing" the BASIC interpreter by 
entering, for example, a zero which later causes a. 

?DlVI5ION BY ZERO ERROR IN LINE 830 

READY. 



In esserce, the computer can only be maximized by the machine lan- 
guage programmer, 

APPROACHING A LARGE TASK 

When approaching a large tosk in machine language, u certain 
amount o f subconscious thojght has usually taken place. You think 
about how certain processes are caried out In machine lunyjuge. 
When the task is started, it is usually a good idea to write it out on 
paper. Use block diagrams of memory usage, functional modules uf 
code required, and n program flow, let's say that you worted to write a 
roulette game in machine language. You could outline it something like 
this: 
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• Display title 

• Ask it player recuires inilructions 

• YES — displcy them — Go to START 
■ NO — Go to STARi 

• START Initialize everything 

• MAIN display roulette table 

• Take in bets 

• Spin wheel 

• Slow wheel to stop 

• Check bets vuith result 

• Inform player 

• Playe r any money left? 

• YES— Go to MAIN 

• NO — Inform user!, arid go to SIART 

This is the main ou'line. As each module is approached, you can 
break it down further. If you look at a large indigestible proolem as 
something that cor be b'oken down into small enough pieces, to be 
eaten, then you'll be able to approach something that seems impossible, 
and have it all fall into place. 

This process only improves with practice, so KEEP TRYING, 
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MCS6510 MICROPROCESSOR 


ADC 


Add Memory to Accumulator with Carry 


AND 


"AND" Memory with Accumulator 


ASL 


Shift Left One Bit (Memory or Accumulator) 


BCC 


Branch on Carry Clear 


BCS 


Branch on Carry Set 


BEQ 


Branch on Result Zero 


BIT 


Test Bits in Memory with Accumulator 


BMI 


Branch on Result Minus 


BNE 


Branch an Result not Zero 


BPL 


Branch on Result Plus 


BRK 


Force Break 


BVC 


Branch on Overflow Clear 


BVS 


Branch on Overflow Set 


CLC 


Clear Carry Flag 


CLD 


Clear Decimal Mode 


cu 


Clear Interrupt Disable Bit 


CLV 


Clear Overflow Flag 


CMP 


Compare Memory and Accumulator 


CPX 


Compare Memory and Index X 


CPY 


Compare Memory and Index Y 


DEC 


Decrement Memory by One 


DEX 


Decrement Index X by One 


DEY 


Decrement Index Y by One 


EOR 


"Exclusive-Or" Memory with Accumulator 


INC 


Increment Memory by One 


INX 


Increment Index X by One 


INY 


Increment Index Y by One 


JMP 


Jump to New Location 
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INSTRUCTION SET— ALPHABETIC SEQUENCE 



JSR Jump to New Location Saving Return Address 

LDA Load Accumulator with Memory 

LDX Load Index X with Memory 

LDY Load Index ¥ with Memory 

LSR Shift Right One Bit {Memory or Accumulator) 

NOP No Operation 

ORA "OR" Memory with Accumulator 

PHA Push Accumulator on Stack 

PHP Push Processor Status on Stack 

PLA Pull Accumulator from Stack 

PLP Pull Processor Status from Stack 

ROL Rotate One Bit Left (Memory or Accumulator] 

ROR Rotate One Bit Fight (Memory or Accumulator] 

RTI Return from Interrupt 

RTS Return from Subroutine 

SBC Subtract Memory from Accumulator with Borrow 

SEC Set Cany Flag 

SED Set Oectmal Mode 

SE I Set I nterrupt Disable Status 

STA Store Accumulator in Memory 

STX Store Index X in Memory 

STY Store Index ¥ in Memory 

TAX Transfer Accumulator lo Index X 

TAY Transfer Accumulator to Index Y 

TSX Transfer Stack Pointer to Index X 

TXA Transfer Index X to Accumulator 

TXS Transfer Index X to Stack Pointer 

TYA Transfer Index Y to Accumulator 
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The following notation applies to this summary; 

A Accumulator 

X a Y rndex Registers 

M Mf>mnTy 

P Processor Status Register 

S Stack Pointer 

/ Chang* 3 

_ Nn Change 

+ Add 

A Logical AND 

Suhrracr 

¥ Logical Exclusive Dr 

t Transfer from Stack 

♦ Transfer to 5tack 

+ Transfer to 

Transfer from 

V Logical OR 

PC Program Counter 

"Cll Ptugcdic Counter 'iigh 

PCL Program Counter Low 

OPER OPERAND 

9 IMMEDIATE ADDRESSING *ODE 



Note: At the top of each table is located in parentheses a. 
reference number (.Xef : XX) which directs the user to 
that Section in the MCS6500 Microcomputer Familv 
Programming Manual in which the instruction is defined 
and discussed , 
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Add memory to accumulator with carry 
Operation l+K+C + A, C N * C 1 n V 

J J J J 

(Ref; 2,1.1) 



Addressing 


Assembly Language 
Farm 


OP 

CODE 


Ho. 
Byte 3 


No. 
Cycles 


Imnediate 


ADC if Oper 


69 


2 


2 


Zero Page 


ADC 0?cr 


65 


2 


3 


2ero Page, X 


ADC Oper, X 


75 


2 


4 


Absolute 


ADC Oper 


6D 


3 


4 


Absolute f X 


ADC Oper, X 


7D 


3 


4* 


Absolute, Y 


ADC Oper, V 


79 


3 


4* 


< Indirect, I) 


ADC (ap^T, X) 


61 


2 


b 


(Indirect). T 


ADC (Oper) , Y 


71 


2 


5* 



Add 1 if page boundary -s crossed. 



AND 



"AND " memory with accumulator 
Logical AMD to the accumulator 

Operation: A ^ M -* A N 8 C I D V 

(Rof; 2.2.3.0) <? / 



AND 



Alj J Li Hiil.g 


Assenbly Language 


OP 


He, 


no. 


Mode 


Form 


CODE 


Bytes 


Cycles 


Immediate 


AMD (1 Oper 


29 


2 


2 


Zero Page 


AND Oper 


25 


i 


3 ' 


Zero Pige, X 


AND Oper, X 


35 


2 


4 


Absolut * 


AND Oper 


2D 


3 


4 


Absolute, X 


AND Oper, X 


3D 


3 


4* 


Absolute, Y 


AND Oper, Y 


39 


3 


4* 


(Indirect, If 


AND <f>per, X) 


71 


2 


6 


(Indirect) ( Y 


AND (3per), Y 


31 


2 


5 



* Add 1 ir pag* boundary is crossed. 
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335 



ASL 

Operation: C 



ASL Shift Left One Bit (Memory or Accumulator) 

3 



ASL 



,■ 


h 


c . 


4 


■>. 


1 


1 


9 



N 3 C I D V 

/ / .' 



(R*f: 10.2) 



Addressing 


Assembly Laniua^c 


OP 


No. 


No. 


Mude 


Form 


CODE 


Fi^ *~PR 


C>r li's 


Accumulator 


ASL A 


ft 


1 


1 


2ero Page 


ftSL Oper 


06 


2 


5 


Zero Pag e , X 


&S1 Oper, X 


16 


2 


6 


Ah-snlnte 


Asl Oper 


BE 


3 


6 


Absolute, X 


ASL. Oper, X 


IE 


3 


7 



Oj:pration- Branch on C = tf WSCIDV 

(Ref: 4.1.1.3) 



Addressing 
Node 


Assembly Language 

TOriT; 


OP 
CODE 


Ho, 

ByLes 


Ho. 
Cycles 


Relative 


ECC Oper 


9$ 


/ 


I* 



* Add 1 If branch occurs to same page. 

* Add Z if branch occurs to different page. 



BCS 



EL'S firanrh fill carry <et 



BCS 



Operation: Biaiuili ( 


D C - 1 

CtUsf! 4.1.1.4) 


H £ 


C I D V 












Addresair.g 
Mods 


Assembly Language 
Boca 


OF 

code 


tic. 

Bytes 


No. 
Cycles 


Relative 


BCS Oper 


B# 


2 


2* 



* Add 1 if branch occurs to same page, 

* Add 2 if brand) oluuis to i.ext pige. 
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BEG 



BEQ Brunch on result zero 
QperatXan: Branch an S ■ 1 

[Keti 4. L.J. 5) 



BEQ 



S Z C I D 7 



Addressing 

Mude 


Assembly Language 
Form 


OP 
CODS 


No. 

Eytes 


Mo. 

Cycles 


Relative 


BEQ Cper 


FB 


2 


- 



* Add 1 i £ branch occurs to cams page . 

* Add 2 it branch occurs to next pa&e. 



BIT 



BIT Test bits in memor}> with accumulator 



BIT 



Operation: A /l M. M, ■+ ft, A. 

f o 



Eit i and 7 are- transferred to the stacks register. N 3 C I D 7 
zero then Z = 1 

(Ref: 4,2.1.1) 



If tne result of A AM Is zero then Z - 1, otherwise M,/ M, 

a - 



AdcressLiiR 
Mcdu 


Assemibly Laneuace 

Fuiui 


or 

CODE 


No. 

By ,e$ 


No. 
Cycltti 


Absolute 


BIT opei 
BIT Dper 


14 
2C 


2 
3 


-* 



BMI 



BMI Branvii on result minus 



BMI 



Operation ! Branca ori N - 1 

i>£: 4.1,1.1) 



M * C I D V 



AJdrcselng 
Mode 


JLesembl/ Language 

FoTm 


OP 

CODE 


Nn. 

Byt = s 


Ha. 
Cycles 


Relative 


BMI Oper 


n 


2 


2* 



* Add L 11 branch occurs to same page. 

* Add 2 if br»neh scenes to different page- 



BaSIC TO MACHINE LANGJAGE 237 



BNE 



KNE Brunch on resuii not zero 
Operation; Branch or. 2 - M ■£ C I D V 





(Ref: 4.1.1.6) 








Ad A re 5 5 L l'l g 
Mode 


Assembly I_aagu;=ge 
torn 


OP 

CODE 


No. 
Evces 


No. 
Cycles 


Relative 


BNE Oper 


Dfl 


? 


•}* 



* Add 1 if branch occurs to eame page. 

• Add 2 Lf bransJi occurs to different page. 



BrL BPl. Srnnrh tn ri>!Bt!t pi"* 

Operation: Branch on N = 

{Refi 4.1.1.2) 



BPL 



N S C 1 D V 



.V dl I ■:--■ :• L LJ >= 

Hode 


Asstinbly Language 
Form 


OP 
CODE 


Ho. 
Sytea 


No. 
Cycles 


Relative 


BPL Oper 


10 


2 


2* 



* Add It; branch occurs la same page. 

* Add 2 i: branch occurs to different page. 



BRK 



BRK forct Break 
Operation; Forced Interrupt rt + 2 t P + 

CRbE; 9.11> 



n a C I D V 



BRK 



Addressing 
Hade 


Assembly Language 
Fern 


OP 

CODE 


No. 
Eytea 


No. 
Cycles 


Implied! 


BRiC 


<J0 


1 


7 



1. A HKK command cannot be masked by sett lag 1. 
238 BASIC TO MACHINE LANGUAGE 



BVC UVC Branch on overflow dear 

Operation! Bvanch on V = 3 

(Ret: 4.1-1.8) 



BVC 



ti a c i d v 



■- 

Addressing 
Mode 


Assembly Language 
b'oTm 


dp 
CODE 


Ho. 
■ Byres 


— . -, 

NO, 


Relative 


BVC Oper 


51 


? 


2* 



* Add 1 il branch occjrs to same page. 

* Add 2 if branch occjrs to different page. 



EY5 "VS Brunch on tft erflmi set 

Operation: Branch on V = I 



BVS 



K 55 C L I) V 



(Ret: 4.1.1.7] 



Add re s 5 Ln& 

Mods 


Assembly Languagt 
Form 


OF 
CODE 


Bytes 


Bu, 

Cycles 


Ry laLive 


EVS Ope i 


70 


2 


2* 



* Add I if branch occurs to same page. 

* Add 2 if branch occurs to different page. 



CLC 

Operation: > C 



CLC Clear carry flag 



(Ret: 3.0.2] 



h a c 1 d v 
-_ fj 



CLC 



Addressing 

Ncde 


,'^si/" 1 y l angjage 
F&nr 


OP 
CODE 


Ho. 
Bytes 


No, 
Cyzles 


I e:l|j 1 ied 


Cl-C 


IS 


1 


J 
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CLD 



CLD Clear decimal mode 



CLD 



Operations + D 



it ft c i p v 

9 





:Ref: 3.3.;> 








Addrcasir.g 

(fode 


A3senLbly Language 
For* 


OF 

COOE 


No. 

Bytes 


No. 
Cycles 


Imp Lied 


CLD 


PS 


1 


2 



*■ LI CLI dear itiisrrupt dimble bli 

Op* rat Ion : * I 

[Kef: 3,2.2) 



CLI 



N i C I D V 

1/ — 



Addressing 
Mode 


Assembly Language 
7om 


(IP 

tout 


Wo. 

Bytes 


Wo. 

Cycles 


Implied 


CLI 


58 


1 


2 



CLV CLV Cleat overflow flag 

Operation: f » V 

(Kef: 3.6.1) 



CLV 



N £ (J 1 E V 



Acdreysiu^ 
Kodc 


Assembly Language 

Form 


OF 
CODE 


Mo. 
Bytes 


Cycles 


Implied 


CLV 


Bo 


1 


2 
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(.MP CMP Compare memory ami aecumuhtor 

OpeiaLiuu: A-M NSCIDV 

/ / 4 

(Ref: 4.2.1) 



CMP 



Address lug 


/ ^senbly Language 


OP 


Mo. 


MO. 


Wade 


Fori] 


CODE 


Bytes 


Cycles 


luraediaLe 


CMP tfOpei 


C9 


2 


2 


Zoro Page 


CMP Opar 


CS 


2 


3 


Zers fag*;, x 


OIK Lper, l 


D5 


2 


4 


Absolute 


CMP Oper 


CD 


3 


4 


Absolute , X 


CMP Oper, I 


DD 


3 


4* 


Aba d Lute, ¥ 


CMP Oper, t 


D9 


3 


4* 


(I^irtte. K) 


CMP <Oper, X) 


CI 


2 


6 


{Indirect), Y 


CMP (Oper) . T 


111 


2 


5* 



* Add 1 if aa&e boundary 13 crossed . 

\JT A CPX Compare Memory and Index X 

Operation.' X _ M K ! : 1 B V 

(Rpf: 7.H) 



CPX 



v' / / 



Addressing 
Node 


Assembly Language 
Form 


OP 
CODE 


Ho. 
3ytes 


Ho. 
Cycles 


litirc.ediatfl 
iero Page 

AtSoluCe 


CPX * Opei 

CFX ope r 
CPX QpeE 


EB 

E4 
EC 


3 


3 

14 



CPY 

Operation; V 



CPY Compare memory and index Y 



(K.ef: 7.9) 



CPY 



m a c i d v 

4 / / 



Addressing 

Mode 


flsflpmh". y Language 
Form 


01" 

CODE 


No. 
By Les 


No. 
Cycle* 


liu&cdiate 
"prn Page 

AtsoluLe 


CPY*Oper 
OT Ope l 
Cflf Oper 


Ci 


3 


2 

4 
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DEC 



DEC Decrement memory by ore 
Operation: M - 1 -*- H 



DEC 



IfCIK! 

/ / 





(Bef: 10.7) 








Addressing 


Assembly Language 


OP 


Nc., 


No. 


Mode 


Form 


OWE 


Bytes 


Cycles 


Zero Pags 


T)RC [>>^r 


Co 


2 


S 


Zero Page, X 


DEC Oper, X 


D6 


2 


6 


Absolute 


DEC 0p«r 


OE 


3 


6 


Absolute, I 


DEC 3per, X 


DE 


a 


7 



UEA DEX Dtcremert "mtl€x X' tv ore 

Operation: X — 1 -» X 

(ReF; 7.6) 



DEX 



n a c i d v 
/ / 



-Addressing 

Mode 


Assembly Language 
Form 


OP 
COUE 


Ho. 
Bytes 


Ho. 

Cycles 


'fmplied 


DEX 


CA 


1 


i 



DEY Decrement index Y by One 

Operation; V - 1 > Y HBCIDV 

(Hafr 7.7) 



DEY 



Addressing 


Assembly Language 


OP 
CODE 


Ho. 

By Las 


No. 
Cycles 


Implied 

- 


DEY 


8a 


L 


2 
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CUR EOR "Exclusive -Or" memory 'Mith accumulator 

OjHstaLlun: A ¥ M - A HECIDV 

(S,ef! 2.7.3.?) 



EOR 



Addressing 


Assembly Language 


OP 


Bo. 




Mo. 


Mode 


Form 


20DE 


Bytes 


Cycles 


limed late 


ECR #0pei 


49 


2 


2 


Zero Page 


ECR Dpoi 


4 5 


2 


3 


Zero Page, J. 


EOK [?peT, X 


55 


2 


4 


At> $o lute 


ECR Oper 


4D 


3 


'• 


Absolute, X 


EOR DpftT, X 


iD 


3 


4* 


AbauluLe t Y 


ECR 3pei, Y 


59 


3 


4* 


(Indirect, 3i) 


EOR (Oper, X) 


41 


2 


o 


Clndirec:) ,1 


EOK (Oper), f 


51 


2 


5* 



* Add L if pig* boundary is croESid, 

ll« INC Increment memory fry one 

eviration: M + 1 + H 



met; 10,6) 



INC 



N a C I D V 

/ / 



Addressing 


As c emfe ly Language 


CP 


No, 


No. 


Mole 


Form 


CODE 


Eytes 


CyclES 


Zero Page 


INC Oper 


Eg 


2 


5 


Zero Page, X 


INC Oper, X 


P6 


2 


6 


Absolute 


INC Oper 


EE 


3 


6 


Absolute , X 


INC Oper, X 


FE 


3 


7 



I HA IKX Fr.crement Index X by One 

Operation^ i + 1 + I 

(E«f- 7.4) 



INX 



N 2 C I D V 

/ / 



Address Ins 
Mode 


Assembly Language 
Form 


OF 
CODS 


By tea 


No. 
Cycles 


h- ;) 1 j i'.tl 


INX 


E6 


1 


£ 
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FNY Increment fades Y by one 

Operation: Y +■ 1 ■* Y 

<Refi 7,5) 



INY 



H £ C T T V 
/ / 



Addressing 
Mods 


A^stuibly Language 
Fom ■ 


DP 
CODE 


Ha. 

Bytes 


NO. 
Cycles 


I up J led 


ItfV 


38 


1 


2 



JMP 



JMP Jump to new location 



JMP 



Opfratlon: (FC ■+ 1) * TCL 

(PC + 7) + PCH <Kef : *- - 2 ) 
(Eef: 9.8.1) 



M 3 C I D V 



Addressing 
Mod* 


Asacnbly Language 

Form 


cr 

CODE 


bo. 

Sytee 


No. 
Cycles 


Absolute 
Indirect 


JMP Oper 
JM? (Cper) 


6C 


3 
3 


3 
5 



JiK JSR Ju-?;p Jo nctv location saving return jddiess 

Operation; K t 2 t, (PC + 1) ■> FCL N 2 C I D V 

(PC + 2) ■* PCH 

(Kef; S.lj 



JSR 



Ad J resting 
Mode 


Assembly Language 

Form 


OP 

CODE 


No. 

By Las 


No. 
Cyclas 


Absolute 


JSK Oper 


i!U 


i 


6 
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LI* A LD\ Lvad accumulator with memory 

'JpertCion: M -. A 11 3 C 1 D V 

/ / 

(Eef: 1,1.1) 



LDA 



Addressing 


Assembly Language 


(IP 


Ho, 


KTh . 


M^cte 


Torn 


~ODE 


Bytes 


Cycles 


inmediace 


LGA#flper 


A9 


2 


1 


Se re Page 


IX A D;jer 


A5 


2 


3 


'/.pre. Pq^p, X 


LEA 3per, X 


Hi 


2 


i 


Ab&eiute 


LDA OpeT 


AU 


3 


4 


Absoluts , i 


LDA Oper, X 


BD 


3 


4* 


Absolute, "i 


LDA Oppr, Y 


BO 


3 


4* 


(Indirect, X) 


LDA (Optr, KJ 


A1 


2 


6 


(Indirect), I 


LDA (Oper), V 


Bl 


I? 


5* 



* Add 1 if pag-e LiuundidLv iw ^ t ys-seti . 



LDX 

Operation; M 



LDX Litud Index X with memory 



(Bef: 7,0) 



n a C I D V 

y / ■ 



LDX 



Address 1 ng 


Assembly Language 


OP 


SO. 


No. 


Mode 


Form 


CODE 


Eyt« 


Cycles 


UUMedLilt 


LDX <> Ops i 


A2 


a 


2 


Zero Page 


LDX Oper 


AS 


2 


3 


,Ztsro Fafce, i' 


LDS Oper, X 


B6 


2 


4 


Absolute 


LDX Oper 


AE 


3 


4 


AbsoLute, Y 


LDX L'per. I 


Bt 


3 


1* 


- 











* Add 1 when page boundary te crossed, 
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LOT 

Operation: M 



LDY Load !>id«; ¥ with memory 



(Re£: 7.1) 



LDY 



H a C I E V 

/ / 



Addressing 


Assembly Language 


OP 


Ho. 


No. 


Mod* 


Form 


CODE 


Bytes 


Cycles 


Immediate 


LEY #Oper 


A« 


2 


i 


Zprn ?Agp 


LDY Oper 


A4 


2 


i 


Zero Page, X 


LEY Opt i , X 


M 


2 


4 


Absolute 


LEY Opei 


*r 


1 


A 


Absolute, H 


LDT oper, X 


BC 


J 


;,* 



* Add 1 vher. page hnundary is crossed. 



LSR 



LSR .%'fti/f right one hit fmemary of smtmiiatoti 



LSR 



Operation; 



7 


6 


5 


j j 


"i 


;•' 


] 


:) 



— c 



,{Ref: 10.1) 



mem; 
e / / 



AU JltfSiilLtg 


Asienbly Language 


OP 


Mo. 


He. 


Mode 


Form 


CODE 


Bytes 


Cycles 


Ac junulator 


LSR A 


4A 


1 


2 


^prn P^B? 


LSR Oper 


46 


2 


5 


Zero Psie, X 


LSR Ope I. X 


56 


2 


6 


AbeeJ ute 


LSR Oper 


4E 


3 


6 


Absoluts. S 


LSK Oper, A 


5E 


i 


7 













NOP NOP No operation 

Operation; No Openatijir (2 cycles) 



HOP 



H S C 1 D V 



Addressing 

Mude 


Assembly Language 

Form 


OP 
CODE 


Mo. 

!'■;,- ■■■ ■ 


Ha. 

Cycles 


Implied 


HOP 


EA 


1 


2 



1A6 BASIC TO AtACHINE language 



WMW ORA "OR" memory witk accumxh tor UKA 

Operactoa: A V K •* A M 3 C I D V 

(Eef: 2,1.3.1) ' " " 



A<idrest?x.ig 

Mode 


Assembly Language 
Fuc'iii 


Or 

CODE 


So. 
By:eM 


Ho. 

Cycles 


Inmeiliate 


ORA sfoper 


ti<* 


■; 


2 


lerc Faje 


OKA Oper 


05 


2 


3 


Zero Page, X 


ORA Dppr, X 


15 


2 


4 


Absolute 


ORA Oper 


9D 


i 


4 


Absolute , X 


OKA Oper, X 


IE 


2 


4* 


Absolute, 1 


CRA Oper, Y 


19 


3 


4* 


l| Indirect , 5i) 


ORA (Optc, X) 


fll 


I 


6 


(Indirect), Y 


CRA (Oper), Y 


11 


2 


5 



* Add 1 en page crossi 



PHA 


PH A Push accumulator on stack 






PHA 


Operat ion : A t 




NiCIH 






(Ret: E.5) 







Addressing 


Assembly Language 




OP 


Bo. 


He. 


Modt 


Form 




CODE 


Bytes 


Cycles 


ItriplLed 


p:ia 


43 


1 


3 



PHP Push processor status on stack 
0(jeiaHjr: F+ J i C I 1 V 

(Kef : 8.11) 



AdJressitiK 

Mode 


Assembly Language 

Form 


OP 
COD 2 


No. 
Bytes 


No. 
Cvcles 


imslled 


FHF 


m 


1 


3 
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PIA 



OpeiaLion: A 1 



PLA Full accumulator from stock 



(Rcf: 8,5) 



PU 



n a c J u v 
/ / 



AddLtss ii]^ 
Made 


Assembly Lin^ua^j 

Funn 


OP 

CODE 


H(J. 
lytes 


Mo, 

Cycles 


Implied 


PLA 


68 


1 


4 



PIP 



PLP Full proc&aarsnatus. )mm stuck rll 

Operatic™ : P t N3CIDV 



(Ref: R.13) 



Fr r>n S t acle 



Addressing 

Made 


A4K*»mh7y Language 

Forn 


OP 
CODE 


Kg. 


Ho. 

fyrl pi 


Implied 


FLP 


28 


1 


4 



ROL Rotate oris bit hft{ memory or accumulator) 

I . w ,°r i 

Operation: |_ |7|tt]5|4]3| 2 ' 1 1 fl | +- jT/ 1 



ROL 



N e C I D V 
/ / / 



(Ret: J.U.3) 



Addressing 
Mode 


Assembly Language 
Form 


3P 
COTE 


to. 

3yt2fi 


to, 
Cycles 


Accumul^tut 


ROL A 


2A 


1 


2 


Zero Page 


ROL Oper 


2i 


2 


5 


Zero Page, £ 


ROL Oper, X 


36 


2 


b 


Absolute 


KOL Upe r 


2E 


3 


6 


Absolute, I 


HClt. Oper, X 


3E 


3 


7 
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ROR 



ROR fiotaieon-c bit right {memory or accumufatorj 



ROR 



Oper. 



,cion: *— HjD-HI 



(Hef: 10.11 



KKID7 
/ / t 



Addressing 
Hods 


Asscnbly Language 

Form 


OP 

COEE 


No. 

BTtes 


Ro. 

Cycles 


Ac Lunu !<!*-[_> i 


ROR A 


*A 


1 


2 


Zero Page 


ROR Oper 


f.fi 


1 


5 


Zero Fage,X 


ROR Oper,X 


76 


1 


£ 


Absolute 


ROR Opcr 


in 


3 


6 


Ahnfilnrfs.X 


RH Oper f X 


IE 3 


7 



Note' ROR instruction i« available on MCS650K. nicro- 
prnrP-^snrK after Jun& t 1976. 



RTI Rcittrfi fritrrt hiitrfupt 

Crperacion: Ft FCt H 2 C I D V 

Fr<-vfn Flrar'U 



RTI 



Addressing 
Mode 


Assembly Language 

Ffirm 


OP 

CODE 


No. 

Bytes 


No. 

Uycles 


Implied 


RTI 


hi 


1 


s 



RTS 



RTS Return fro*t\ subroutine 
Operation: FC+, PC + 1-* PC H B C r d v 

CRel: 8.k) 



RTS 



Addressing 
Mode 


Assembly Language 
Form 


3? 
CDDE 


No. 
Bytas 


So. 
Cyclpfi 


Implied 


RTS 


50 


1 


6 
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*"*^ SBC Subtree! memory front accumulator v,iih borrow SBC 

Operation: A - H - C" ■* A WSCID^J 
Bote: C = Eorrou <Ecf: 2.2.2) f ■} J 4 



Addressing 

Mode 


A33emfclj Language 
Form 


or 

CODE 


Ho, 
Sytcs 


Ho. 

Cycles 


Immediate 


SBC#Qptr 


E9 


^ 


2 


Zero faje 


SRC Oper 


ES 


*» 


3 


Eexo Fi^c, x 


SBC Oper, X 


ra 


2 


4 


Absolute 


SBC Oper 


ED 


3 


4 


Absolute. X 


SBC Oper, X 


ED 


3 


4* 


Absc.1 jce , V 


SBC Oper, ? 


F9 


3 


4* 


(Indirect, jf) 


SBC (Oper, if] 


El 


£ 


6 


(Indirect) , ¥ 


SBC (Oper), y 


Fl 


2 


5* 



* Add 1 uhen page boundary is crossed. 



SEC 

Operation; i -+ c 



SEC Set uarry flgg 
(Kef; 3.0.1) 



SEC 



N 2 c I D V 



Addressing 
Mode 


Assembly Language 
Foin 


OP 
CODE 


No. 

Byr^s 


Ho. 

Cycles 


Implied 


KEC 


38 


1 


2 



SED Set dzcimut mode 
Operation: 1 -* B 



SED 



{Ref: I.T.lj 



N 3 C I p V 



Addressing 
Mode 


Assembly Language 
Fcrm 


OP 
COUE 


Ho. 

Bytes 


Ho. 

C.yc.l ps 


Implied. 


SED 


FS 


1 


1 
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SE1 



SEI Se; interrupt disable status 



SEI 



Operation' 1+1 



(Ref: 1.2.1) 



n s C I n v 



Addressing 
Kode 


Assanbly Laniusee 
Farm 


OP 

CODE 


Be. 

Bytes 


P.a. 
Cycles 


Implied 


SEI 


in 


1 


2 



>TA STA Store accumulate? in memory 

3ptraelon: A -► H N 2 C I L V 



STA 



(Kef: 2.1.2) 



Addressing 


Assftnbly Language 


OP 


No. 


Nn. 


MrsHp 


Form 


(JUUi 


tytes 


Cycles 


2«ro Page 


STA Oper 


S3 


2 


3 


£ero Page , X 


STA Oper, X 


95 


2 


4 


Absolute 


ETA Oper 


8D 


3 


A 


Ahsoljce, X 


5IA Oper, X 


9D 


3 


5 


Atsolu^Cj ^ 


STA Oper, !f 


99 


3 


5 


(Indirect, K) 


STA (Ojipr, X) 


SI 


2 


b 


(indirect:), Y 


SIS (Oper), If 


91 


2 


(, 



STX 



Operation: X ■* H 



STX Sro« index X in memory 

w a c i d v 



(fUsis 7.2) 



Addressi ng 

Mode 


Assembly Language 
Form 


OP 
CODE 


so. 

3}tes 


No. 
Cycles 


Zero Page 
zero Page , Y 
Absolute 


KTJf Dpfir 
STX Oper, T 
SIX Oper 


86 
96 
SE 


? 
2 
3 


1 

4 
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J I 1 STY Store index >' in memory 

Operation: Y + M 



STY 



H a C I D V 





(Kef: 7.3) 








AJdi easing 
Mode 


Assembly Language 


OP 
CODE 


Mo, 

Bytes 


Ho. 
Cycies 


£ero Faga 
Zero Page, JL 
Absolute 


STY Oper 
STY Oper, X 
STY Oper 


84 
9i 
8C 


2 

2 
3 


3 

4 

4 



TAX TAX Tmiufer accumulator to index X 

Ope rati en: A + X SlJCIDV 

/ / 

(Ref; 7.11) 



TAX 



Addressing 


Assembly LanfuAg? 

Farm 


OP 

cqdk 


Mo. 

Bytes 


Ho. 
Cycles 


loplied 


TAX 


AA 


1 


2 



TAY 



TAY Transfer accumulator io index Y 
Operation: A-f N2C1EV 

J J 

(Kef: 7.13) 



TAY 



Addressing 
Node 


Aaaembly Language 
Farm 


OP 
CODE 


Hl.. 
Bytes 


Mt. 
Cvcles 


Inpliei 


TtS 


A8 


1 


1 
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TSX 



Operation: S ^> X 



TSX Tmmifer start painter to index X 



TSX 



[Rtf: 8.9) 



IICIDV 
/ / 



Addressing 


4$Kembly Language 
Farm 


CEWE 


No. 

Hytes 


No. 

Cycles 


Implied 


rsi 


BA. 


1 


2 



TXA TXA Transfer ind*x X to accumulator TXA 

QpscaLiun: X f A N 3 C I D V 



(Kef: 7.12.) 



/ / 



Addressing 

Mode 


Assembly Language 
Forn 


OP 
CDDE 


Ho. 

Bytes 


Ma. 

Cycles 


Implied 


TXA 


SA 


1 


2 



Taj TXS Transfer index X to stack pointer 
Operation; X--S K 2 C I D V 
(Ref ; 8.S) 



TXS 



Addles^! .t£ 
Mode 


Assembly Laiigjage 
Form 


or 

COLE 


0<i. 
3ytes 


Ho. 
Cycles 


Imp 11k J 


T5«S 


9jS 


1 


2 



fA TVA Transfer iridzx Y to accumulator 

Operation: t » A N2C1EV 



HA 



(Ref: 7.1* 



V' / 



Hode 


Assembly Language 
lorm 


or 

CODE 


Me. 

Bytes 


Cycles 


Implied 


TYA 


96 


1 


2 
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INSTRUCTION ADDRESSING MODES AND 



x > 



iUM 



X > 

S 8 £ 



s ** s 



c -o a. a. a. as 3 $ ,> s S 3 



o o o — = •= ■= a 

a -3 J 1 J 



u c o o 

i E • • ! 5 5 3 £ ,S 3 



ADC 

AND 

ASL 

BCC 

BCS 

BEQ 

BtT 

BMI 

BNE 

BPL 

BRK 

BVC 

BVS 

CLC 

CLD 

CLI 

CLV 

CMP 

CPX 

CPY 

DEC 

DEX 

DEY 

EOR 

INC 

INX 

INV 

JMP 



2 3 4 
2 3 4 
5 6 



2 3 

2 3 

2 3 

. 5 



2 3 4 
5 6 



4 4* 4* 
4 4* 4' 
€ 7 



2 
2 
2 

2 



4 4* 4* 

4 
4 
6 



4 4* 4' 
6 7 



3 , . 



2 
2 



2 

2 



6 5* 
6 5" 



2". 

*?* * 

2* 



6 5' 



6 5' 



* Add one cycle i1 indexing across page boundary 

** Add ore cycle if branch is talc*n, Add one additional 
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RELATED EXECUTION TIMES (in clock cycles) 



X > 



x > 
S - - 

5- B • 

3 .2 

E 1 

ocfeScS-g-a-gpoce 



C> n 9 a « 

ro ro CD ** ^ +j 

c a. Q. a a 3 

o o o 



s 

_ _ (B 

u 
3 



333S.> « 63 

O O O — H •- i- O 

M 

3 



JSR 

LDA 

LDX 

LDV 

LSR 

NOP 

ORA 

PHA 

PHP 

PLA 

PLP 

ROL 

ROR 

RTI 

RTS 

SBC 

SEC 

SED 

SEI 

STA 

STX 

STY 

TAX 

TAY 

TSX 

TXA 

TXS 

TYA 



if branching operation crosses page boundary 



2 


. . . 6 . . . 

1 3 4 . 4 4* 4' . 
1 3 4 4 . 4* 
i 3 4 . 4 4V . 
5 6 6 7. . 

, . . 2 


6 5* . 
6 5* 


2 


2 3 4. 44*4*. 

3 

3 

. . 4 

. . . . 4 

5 6 6 7.. 


2 


5 6. 67. . 
6 


6 5* . 
6 6 




. , . . . . 6 
I 3 4 . 4 4* 4* . 

2 

. . . . . . 2 

2 

3 4 4 5 5. 
3.44. . . 
3 4 4 




. . 2 


. 




2 

2 

2 

2 

2 
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00 - BRK 

01 - ORA - (Indirect, X) 

02 — Future Kxpans-irn 

03 - Kuture Expansion 

04 - Future Expansion 

05 - OEA - Zero Page 

06 - ASL - Zero Page 

07 - Future Kxpansion 

08 - PHP 

09 - ORA - Immediate 
0A - ASL - Accumulator 
0B - Future Expansion 
0C - Future Expansion 
0D - ORA - Absolute 

0E - ASL - Absolute 
0F - Future Expansion 

10 - BPL 

11 - ora - (Indirect) ,1 

12 - Future Expansion 

13 - Future Expansion 

14 - Fucura Expansion 

15 - ORA - Sere Page,X 

16 - ASL - Zero Page,X 

17 - Fuiuie Expansion 

18 - Cl.C 

19 - ORA - Absolute,? 
1A - Future Expansion 
IE - Future Expansion 
1C - Future Expansion 
ID - ORA - Absolute, X 
IE - ASL - Absolute, X 
IF - Future Expansion 



20 - JSR 

21 - AND - (Indirect ,X) 

22 — Kuttirp Kxpanslon 

23 - Future Expansion 
2h - BIT - Zero Page 

25 - AMD - Zero Page 

26 - ROL - Zero Page 
7.7 - Future Kxpansion 

2a - plp 

29 - AND - Immediate 
2A - ROL - Accumulator 
2B - Future Expansion 
2C - BIT - Absolute 

2D - AMD - Absolute 
2E - ROL - Absolute 
2F - Future Expansion 

30 - BM1 

31 - AND - (Indirect.), i 

32 - Future Expansion 

33 - Future Expansion 
31 - Future Expansion 

35 - AND - Zero Page,X 

36 - HOL - Zero Page,X 

37 - Future Expansion 
3fi - SEC 

39 - AND - Absolute, ¥ 

3A - Future Expansion 

3B - Future Expansion 

3C - Future Expauslou 

3D - AND - Absolute, X 

3K - ROL - Absolute, X 

3F - Future Expansion 
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40 - KT1 

41 - EOS. - (Indirect,*) 

42 - Future Expansion 

43 - Future Expansion 

44 - Future Expansion 

45 - EOR - Zero Page 

46 - LSR. - Zero Page 

47 - Future Expansion 

48 - PHA 

49 - EOR - Immediate 
4A - LSR - Accumulator 
4B - Future Expansion 
4C - JMP - Absolute 

4D - EOR - Absolute 
4£ - LSR - Absolute 
4? - Future Expansion 
5$ - BVC 

51 - EOR - (indirect),? 

52 - Future Expansion 

53 - Future Expansion 
5^ - Future Expansion 

55 - EOR - Zerc Page.X 

56 - LSR - Zero Fage.X 

57 - Future Expansion 

58 - CLE 

59 - EOR - Absolute, Y 
5A - Future Expansion 
5B - Future Expansion 
5C - Future Expansion 
5D - EOR - Absolut* ,X 
5E - LSR - Absolute, X 
5F - Future Expansion 



60 - RTS 

61 - ADC - (Indirect, X) 

62 - Future Expansion 

63 - FuLure Expansion 

64 - Future Expansion 
6i - ADC - "Zero Page 

66 - ROR - Zero Page 

67 - Future Expansion 

68 - PIA 

69 - ADC - Immediate 
6a - ROR - Accumulator 
6B - Future Expansion 
6C - JM? - Indirect 

6D - ADC - Absolute 
6E - ROR - Absolute 
6F - Future Expansion 

70 - BVS 

71 - ADC - (Indirect), Y 

72 - Future Expansion 

73 - Future Expansion 

74 - Future Expansion 

75 - ADC - Zero Page.X 

76 - ROR - Zero Page.X 
7 7 - Kuture Expansion 

78 - SEI 

79 - ADC - Absolute, Y 
7A - Future Expansion 
7B - Future Expansion 
7C - Future Expansion 
7D - ADC - Absolute, X 
7E - ROR - Absolute,X 
7F - Future Expansion 
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30 - Future Expansion 
SI - STA - (Indirect ,X) 

82 - 1'uture Expansion 

83 - Future EKpar.sion 
34 - STY - 2ero Fage 
85 - STA - Zero Page 
80 - STX - Zero Fage 

87 - Future Expansion 

88 - DEY 

89 - Future Expansion 
8A - TXA 

SB - Future Expansion 

sc - sty - Absolute 

8D - STA - Absolute 
3E - STX - Absolute 
8F - Future Expansion 

90 - BCC 

91 - ETA - (Indirect) ,Y 

92 - Future Expansion 

93 - Future Expansion 

94 - STY - Zero Pagf?,* 

95 - STA - Zero Fage,X 
9fi - STX - Zero Pa'ge 3 Y 
91 - Future Expansion 

98 - TYA 

99 - STA - AbsoluLe.Y 
9A - TXS 

9B - Future Expansion 
9C - Future Expansion 
9E - STA - Absolute,!: 
9E - Future Expansion 
9F - Future Expansion 



A0 - 1DY - Immediate 

A: - LDA - (Indirect ,X) 

A2 - LDX - Immediate 

A3 - Future Expansion 

M - LDY - Zero Page 

A5 - LDA - ZeTO Pags 

A6 - LDX - Zero Page 

A7 - Future Expansion 

AS - TAY 

A9 - LDA - Immediate 

AA - TAX 

AB - Future Expansion 

AC - LDY - Absoluts 

All - r.tlA - Absolute 

AE - LDX - Absolute 

AF - Future Expansion 

B0 - BCS 

Bl - LDA - (Indirect) ,Y 

B2 - Future Expansion 

B3 - Future Expansion 

B4 - LDY - Zero ^age.X 

E5 - LDA - Zero Page,X 

B6 - LDX - Zero Page.Y 

B7 - Future Expansion 

B8 - CLV 

B9 - LDA - Absoluts, Y 

BA - TSX 

Bl - Future Expansion 

BC - LDY - Absolute,X 

BD - LDA - Absolute, X 

BE - LDX - Absolute, Y 

BF - Future Expansion 
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C0 - CPY - Immediate 
CI - CMP - (Indirect ,X) 
C2 - Future Expansion 
C3 - Future Expansion 
Ci - CPY - Zero Page 
C5 - CMP - Zero Page 
C6 - DEC - Zero Page 
C7 - Future Expansion 

ca - ore 

C9 - CMP - Immediate 

CA - DEX 

CB - Future Expansion 

CC - CPY - Absolute 
CD - CMP - Absolute 
CE - DEC - Absolut?. 
CF — Future Expansion 
DfJ - BNE 

Dl - CMP - (Indirect)-,* 
D2 - Future Expansion 
B3 - Future Expansion 
D^ - Future Expansion 
U5 - i.:mp - Zero Page.X 

E6 - DEC - Zero Page,X 
D7 - Future Expansion 
CS - CLO 

DS - CMP - Absolute, Y 
EA - Future Expansion 
EE - Future Expansion 
DC - Future Expansion 
ED - CMP - Absolute V X 
DE - DEC - Absolute, X 
DF - Future Expansion 



m - CFX - Immediate 
El - SEC - (lndirect,X) 
E2 - Future Expansion 
E3 - Future Expansicn 
54 - CPX - Zero Page 
35 - SEC - Zero Page 
i6 - INC - Zero Page 
E7 — Future Expanslcn 

eb - iyx 

Kf - SBC - Immediate 
EA - WOP 

E3 - Future Expansion 
EC - l";PX - Absolute 
ED - BBC - Absolute 
IS - IMC - Absolute 
E? - Future Expansion 
Ff5 - DEQ 

Fl - SBC - (Indirect) ,Y 
F2 - Future Expansion 
F3 - Future Expansion 
F4 - Future Expansion 
F5 - 3EC - Zero Page,X 
F6 - INC - Zero Fage,X 
F7 - Future Expansion 
FS - SED 

F9 - SK<_: - Absolute, Y 
FA - Future Expansion 
FB - Future Expansion 
FC - Future Expansion 
FD - 3BC - Absolute, X 
EE - ISC - Absolute ,X 
FF - Future Expansion 
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MEMORY MANAGEMENT ON THE 
COMMODORE 64 

The Commodore 64 las 64 K byte* of RAM. It olso has 20K bytes of 
ROM, containing BASIC, the operating system, and the standcrd char- 
acter set. It also accesses inpulVautput devices as a 4K chunk of mem- 
ory. How is this all pojsible on a computer wilti u 16-bit address bus. 
that is normal y only capable of addressing 6-1K? 

The secret is in the 6510 processor chip itselF, On the chip is an input/ 
output port. This port is used to control whether RAM or ROM or I/O will 
appear in certain portions q~ the system's memory. The port is also used 
to contrc! the Datassette™, so it is important to affect oily the proper 
bits. 

The 6510 inpjr/nLtput port appears at location 1. The data direction 
register fcr this port eppea-s at location 0. The port is conlrulled like any 
of the other input/output ports in the system . . the data direction, 
controls whether o given bit wi I be an inpul or on output, and the actuu' 
dalG t-ansfer occurs through the part itself. 

The lines in the 6510 control port crc defined at tallows: 



NAME 


BIT 


DIRECTION 


DESCRIPTION 


LORAM 





OUTPUT 


Cnntrol for RAM/ROM at 
$AO00-$3FFF (BASIC) 


HIRAM 


1 


OUTPUT 


Control for RAM/ROM at 
$E00O 4FFFF (KERNAL) 


GHAREN 


2 


OUTPUT 


Control for I/O/ROM at 
£D00G-$DFFF 




3 


OUTPUT 


CasseUe write line 




A 


INPUT 


CassettB switch sense 




5 


OUTPUT 


Cassette motor control 



The proper value for the data direction register is us follows: 

BITS 5 4 3 2 10 
10 1111 

(where I is an output, and is nn inpul) 
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This gives a value of 47 decimal The Commodore 64 automatically 
sets the data direction registe' ta f hls value. 

The control lines, In general, perform the Function given in their de- 
scriptions. However, a combination of contra lines are occasionally used 
to get a particular memory configuration. 

LORAM (bit 0) can generally be thoughr of as c control h'r>e which 
bonks The SK byte BASIC ROM in and out of the microprocessor address 
space. Normally, fh : s line is HIGH for BASIC opera-ion. If this line is 
programmed LOW, the BASIC ROM will disappear from the memory 
map and be replaced by SK bytes of RAM from $A00O-$BfFF. 

HIRAM (bit 1) can generally be- thought of as a control inc whicn 
benks the 8K byte KERNAL ROM in ond out of the microprocessor ad- 
dress space, Normally, this line is HIGH for BASIC opera-ion. If this ine 
is programmer LOW, the KERNAL ROW wi'l disappear from the memnry 1 
map and be replaced by 8K bytes of RAM -from $E0O0-$FFFF. 

CHAREN (bit 2) h used orly To bank the 4K byte character generator 
ROM in or out of the microprocessor address space. From tic processor 
point of view, the eharccter ROM occupies the same address space as 
the l, f O devices ($D000-$DFFF). When the CHAREN line is set to I (as is 
normal), the I/O ceviees appear in the microprocessor address space, 
anc the character ROA^ s net accessab e. When the CHAREN bit is 
cleared to 0, the character ROM appears in the processor address 
space, and the I/O devices are not accessable. (The micro processor only 
needs to access the character ROM when downloading tne character set 
from ROM to RAM.. Special care is needed tor this . . . see the section 
un PROGRAMMABLE CHARACTERS in the GRAPHICS chapter). CHAREN 
can be oveTicden by utier control lines in certain memory 
configurations. CHAREN will have no effect an any memory 
configuration without I/O devices. RAM will appear from £DOOC — SDFFF 
instead. 



NOTE: It on/ rriemoiy mop contaiirny ROM, u WRITE {u POKE) tu a ROW kj-.utiun will 
store data in "tie RAM "under" (lie ROM. Wiilir gloo ROW occitkjr stores dato in the 
"hicden" RAM. far example, this allows o hl-resoluTlon screen to be kepr underneath 
o ROM, ond be changes without havirg to bark the screen bock Tuo the processor 
acdress space. Of earns* n READ nt c ROW location ■•vill return the con-ents of the 
ROM. not the "hidden" RAM. 
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COMMODORE 64 FUNDAMENTAL MEMORY MAP 



EOCQ-FFFF 



DC03-DFFF 



ecoo-CFFF 



AOOT-PFFF 



800O-SFFF 



0000-3 FFF 



I/O BREAKDOWN 



BK KbHNAL HUM 
OR 
FAN 



IKIlO OR RAW OR 

CHARACTER ROM 



3K EA.SIC ROM 

OR 

FAW 

on 

ROM PUKi-IN 



6K FAW 

OR 

ROM PLUG-IN 



I6K RAM 



D000-D3FF VIC (Video Controller) IK Bytes 

D400-D7FF SID (Sound Syntheii*er) 1 K Bytes 

D800-DBFF Color RAM !K Nybbles 

DC0O-DCFF CIAT (Keyboard) 256 Bytes 

DD0O-DDFF CIA2 (Serial Bus, User Port/RS-232) 256 Bytes 

DEO0-DEFF Open I/O slot #1 (CP/M Enable) 256 Bytes 

DF00-DFFF Open I/O tlot #2 (Disk) 254 Byte* 
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The two open I/O slots are fnr general purpose user I/O, special pur- 
pose I/O cartridges (such as IEEE), and have been fenlultvely designated 
fo r enabling the Z-flO cartridge tC^ffA option) end for intertac ; ng to a 
low-cost high speed dis< system. 

The system provides for "autn-start" of the program in a Commodore 
64 Expansion Cartridge. The ccrtridge program is started if the first nine 
bytes of the cartridge ROM starring at lacntion 32768 ($8000) contain 
specific data. The first two byte3 must hold the Cold Start vector to be 
used by rhe cartridge program. The next twn bytei at 32770 ($8002) 
Tiust be the Warm Start vector used by the cartridge program. The next 
three bytes must be the letters, CBAA, with hit 7 set in each letter. The 
last two bytes must be the digits "SO" in PET ASCII. 



COMMODORE 64 MEMORY MAPS 

The following tabies I'st the various memory configurations available 
on the COMMODORE 64, the stares of the control lines which select each 
memory map, amc the intended use o~ each map. 



EDOO 
D000 
CO0Q 

AOOO 

8000 



■1000 



00CO 



KK-KtHNALKOft/ 



4KKO 



4K RAM (SUFFER) 



SKBASCRDM 



8K.RAM 



16KRAM 



16K RAM 



X * DON- CARE 

= LOW 

1 = HIGH 

LORAW = 1 

HIRAM = 1 

GAME - 1 

FXROM = 1 



riiis is ris default basic mummy 

map *hich picwiaes BASIC 2,0 and 

36K COiViguous bytes 0lu5arPAM. 
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S63 



eooq 

DOOO 

CODO 



bUUJ 



4000 



0000 



3KRA.M 



4KI/0 



4KF.AM 



16KF1AM 



10KRAM 



ISKRAM 



X = DON'T CARE 


a VOW 




1 = HIGH 




LORAM 


= 1 


HIRAM 


= 


GAME 


- 1 


EX ROM 


= X 


OR 




LORAM 


- 1 


HIRAM 


= 


GAME 


= 


|THE CHARACTER ROM 


IS MOT ACCESSIBLE EY 


THE CPU IH 


THIS MAP) 


EXROM 


= 



Thiia map provides £0K byloa ol 
RAH end I/O dyviteb-. The user 
must wnte tllB own IJQ driver 

routines 



EOOO 

D00O 
COCO 



8000 



4000 



0000 



£KKERNALRGM 



4KliO 



4KRAM 



16KRAM 



16KRAM 



13KRAM 



X = DON 1 1 CAHt 

= LQM 

1 = HlfiH 



LORAM = 

HIRAM = 1 

GAME = I 

EXROM = X 



This map is intended for use with 
sohload l;(igu;.gos( no.uding 
CPfMi, provitJinj 82ft oentiaroUB 
byies cf user RAVI, uo devices, 
and IjD r river rnttln&s. 
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16K. RAM 



COCO 



8000 



400D 



00CO 



(6KRAM 



I6KRAM 



16KRAM 



X - DONTCARE 


= LOW 




1 - III3H 




LOR AM 


= 


HIRAM 


= 


GAME 


= 1 


EXROM 


= X 


OF 




LORAM 


= 


HIRAM 


- 


GAME 


= X 


EXROM 


= 



Thi5 rrflp gives flGCfifA to a-ll £)4K 
bytss of RAW. Ti8 HO devices 
roust be tanked back into the 
processor's address space lo r any 
I/O operation. 



SK KEflNAL ROW 



EQOC 

D00C 

cooo 

A00O 
8000 



100C 



0000 



4KIJO 



iK RAW (BUFFER) 



8K BASIC ROM 



OK ROM CARTRIDGE 
(BASIC EXP) 



1SKRAM 



fiK RAM 



X = DON'T CARE 

_ LOW 

1 = HIGH 

LORAM = 1 

HIRAM = 1 

GAME = 1 

EXROM - 



Thb \9 Ihs alaidard configuration 
for a BASIC sys:em with i BASIC 
expart&isn ^oy Thic map provides 
32K contiguous bytes or user HAM 
and up Lo SK bytes of BASIC 
"ernaneemenL" 
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16! 



EOCO 

D00O 
cnnc 

AOOO 
8000 



4000 



OCOO 



MKEHNALRDM 



4K l/C'J 



4K RAVI (BUFFER) 



8K ROM (CftRTRlUQfcl 



8KRAM 



-,6K RAM 



H riK HAN/1 



X = DON'T CARE 

= LOW 

1 - HIGH 



LOHAIYI = 

HIRAM = f 

GAME = 

EXROM = 



This manprovldse ^OK contiguous 
bytes of user (\fiM ard up l.j. 8K 
byte- ot pug-in ROM for special 
FtQWtased arjalica-inn?; vrhirh don't 
require BASIC. 



EOOO 
DODO 

ceo: 



aooo 



4000 



oooo 



8KKERMALROM 



AK I/O 



IKFAM(RllFFFR) 



13KROM (CARTRIDGE] 



16K RAM 



1SKRAM 



DON'T CAfLE 

LDiAJ 

HIGH 



LORAM = 1 

HIRAM = 1 

GAME = a 

EXROM = 



This map provides 32K contiguous 
byU£ of titer ftAVl snd M3 to 16K 
t>yle^ ot plug-in ROM fcr eoeoiel 
rtOM-jaaed applirjal ufis whiuli rjon't 

iepLi» easig [word processors. 

other languages, etc.). 



266 BASIC TO MACHINE LANGUAGE 



UK CARTRIDGE ROM 



EOOO 
DOOC 
COOQ 

AOOO 

8000 



loon 



1000 

0000 



<-K I'O 



4KOPEN 



3KOPEN 



8K CARTRIDGE ROM 



16KOPEN 



12KOPEN 



4KRAM 



X = DOI\TCARE 

= LCVY 

1 = HI3H 



LORAM = X 

HIRAM = X 

GAME = a 

EXROM = 1 



This is th&LLTIMAX video game 
memory map. Nalc Ihal the £K 
byle "ejt^ii isior RAM" for tho 
ULTlWflA if required, s accessed 
nir nlth* ROMMOnnUFfMandanv 
RAk/ in the ce'tridge is gnoted, 
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THE KERNAL 

One of the problems facing progrommerj in the microcomputer field 
is the question o* whar ro do when cnanejes are mode to the operating 
system of the computer by the company. Machine language programs 
wh ! ch toot much time to develop "night no longer work, forc'ng major 
revisions in the program. To alleviate this problem, Commodore has 
developed a method of protecting softv/a-e writers called the KERNAL. 

Essentially, the KERNAL is a standardized JUMP TABLE to the input, 
output, and memory management routines in the operating sysiem. The 
locations of each routine in ROM may change as the system is up- 
graced. But the KERNAL jymp table will always be changed To match. If 
your machine language routines only use the system ROM routines 
through the KERNA,, it will take much less work to modify them, should 
that need ever arise. 

The KERNAL is Ihes uperutiricj system of the Codiniudore 64 computer. 
All input, output, and memory management is controlled by the 
KERNAL. 

To simplify the machine language programs you write, and to make 
sure that future versions of the Corn trio dure 64 operating sysiem dori'l 
make your machine langunge programs obsolete, the KERNAL contains 
a jump table for you to use. By taking advantage of the 39 input/output 
routines and other utilities available to you from *he Table, not only do 
you save time, you also make H easier to translate your programs from 
one Commodore compute'' to another. 

The jump tabfe is located on the last page of memory, in read-only 

memory 'ROM). 

To use the KERNAL jump table, first you set up <he parameters that the 
KERNAL routine needs to work. Then JSR (Jump to SubRoutine) to me 
proper place in the KERNAL jump table. After performing its function, 
the KERNAL transfer^ control bock to your machine language program. 
Depending on which KERNAL rout ne you are using, certain registers 
may pass parame'ers back to your program. The particular registers for 
each KFRNAI routine may be found in the individual descriptions of the 
KERNAL subroutines. 
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A good question at this point is why use the jump table at all? Why 
not just J5R directly to Ihe KE^rVAL subroutine involved? The jump tcble 
is used so that if the KERNAL or BASIC is changed, your machine lan- 
guage programs will si I work. In fulu _ e operating systems r he routines 
may have their memory locations moved around to a different position 
in the memory map , , . but the jump luble will still work correctly! 



KERNAL POWER-UP ACTIVITIES 

1) Or powe'-up, the KERNAL firs- resets the stock pointer, and clears 
decimal made, 

2) The KERNAL then checks for the presence of an autostart ROM car- 
tridge at location $8000 HEX 132768 decimal). If this is present, nor- 
mal initialization is suspended, and control Is transferred to the car- 
tridge code, If an autostart ROM is not present, no-mnl system ini- 
tio, izatbn continues, 

3) Next, the KERNAL Initializes all INPUT/OUTPUT devices. The serinl bus 
is initialized. Both 6526 CIA chips arc set to the proper values for 
keyboard scanning, .and the 60-Hz timer is activated. The SI chip is 
cleared. The BASIC memory map is selected and the cassette motor 
is switched olT. 

4) Next, rh© KERNAL performs a RAM test, setting the top and bottom of 
memory pointers. A so, page zero is initialized, vnd the tape buffer 
is set jp. 

The RAM TEST routine is a nondestructive test starting al location 
$0300 and working upvuarc. Once the test has found the first non- 
RAM location, the -op of RAM has its pointer sel. The bottom of 
memory is alweys *et -to $0800, and the screen setup is always set at 
$0400. 

5) Finally/, the KFRNAL performs these other activities. I/O vectors are 
set to default values. The indirect jump tab e in low memory is estab- 
lished. The screen is then cleared, and ell screen editor va'iables 
reset. Then the indirect at $AO00 is used to start BASIC, 
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HOW TO USE THE KERNAL 

When writing machine language programs it is often convenient to 
use the roulines which are already part of the operating system for 
mp'jt/nLitpLir, nccess to the system clock, memory management, and 
other similar operations. It is an unnecessary duplicanon of e'fort to 
write these rout res oyer and aver again, so easy access to the opera*- 
ing system helas speed machine anguage programming, 

As mentioned hefnre, the KE3NAL is a jump table. This is | u s.t a col- 
lection of JMP ins"ructions to many ooerafing system routines. 

Tn jsp c <ERNAL rouine you must first make all of the preparations "hnr 
the rou-he demands, If one routine says that you must call another 
KERNAL routine first, then thct routine must be celled. If the routine 
expect; yet to put a number in the accumulator, then that number must 
be there. Otherwise your routines have little chance af working the way 
you expect them tc work. 

After all preparatans are made, you must call the routine by means 
of the JSR ins'ructian. A,l KERNAL 'outines you can access are structured 
as SUBROUTINES, and must end with an RTS instruction. Wher the 
KERNAL routine has nnished its task, contra is returned to your program 
at the instruction after tie J5R. 

Many erf the KERNAL routines return error cooes in the status word or 
the accumulator if you have orobems in the routine. Good programming 
practice and the elccoss of your machine language programs demand 
thai you handle Itiis properly, If yut, ignore an error return, the rest uf 
your p-ogram might "bomb." 

That's oil there is to do when you're using the KERNAL. Just these 
three simple steps: 

1) Set up 

2) Call the routine 

3) Error handltng 
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The following conventions are used in describing the KERNAL routines: 



— FUNCTION NAME: Name of the KERNAL routine. 

— CALL ADDRESS: This is tine call address of the KERNAL routine, given 
in hexadecimal. 

—COMMUNICATION REGISTERS: Registers listed under this heading 
are used to pass parameters to artd from the KERNAL routines. 

— PREPARATORY ROUTINES: Certain KL-RNAL routines require that data 
be set up before they ccn operate. The routines needed are listed 
here. 

— ERROR RETURNS; A return from n KERNAL routine with the CARRY set 
indicates that on error was encountered in processing. The ac- 
cumulator will contain the number of the error. 

— STACK REQUIREMENTS: This Is the actual number of stack bytes used 
by the KERNAL routine. 

— REGISTERS AFFECTED: All register* used by the KERNAL routine ore 
listed he r e. 

— DESCRIPTION: A short tutorial on the function ol the KERNAL routine 
is given here. 



The list of the KERNAL routines follows. 
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USER CALLABLE KERNAL ROUTINES 



NAME 


ADDRESS 


FUNCTION 


HEX 


DECIMAL 


ACPTR 


$FFA5 


63445 


Input byte from serial 
port. 


CHKIN 


$FFC6 


65478 


Open channel for input 


CHKOUT 


$FFC9 


65481 


Open channel for output 


CHRlN 


$FFCF 


654B7 


Input charterer from 
channel 


CHROUT 


$FFD2 


65490 


Oufpul character to ehan- 


CiOUT 


JFFAS 


65443 


n o I 
Output byte to serial port 


CINT 


$FF81 


65409 


Initialise screen editor 


CLALL 


$FFE7 


655 11 


Close all channels and 
files 


CLOSE 


$FFC3 


65475 


Close a specified logical 
fie 


CLRCHN 


$FFCC 


65484 


Close inpul and output 

channels 


GETIN 


$FFE4 


65508 


Get character from 
keyboard queue 
(keyboard buffer) 


IOBASE 


$FFF3 


65523 


Returns hose cd dress of 

|/Q devices 


IOINIT 


$FFS4 


65412 


Initialize input/output 


LISTEN 


SFFB1 


65457 


Command devices on ihe 
seritil bus to LISTEN 


LOAD 


SFFD5 


65493 


Load RAM fujm u device 


MEMBOT 


SFF9C 


65436 


Read/set the hottoiri of 
rrvemory 


MEMTQP 


$FF99 


65433 


Read/set the top of mem- 
ory 


OPEN 


3FFC0 


65472 


Open a logical file 
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NAME 


ADDRESS 


FUNCTION 


HEX 


DECIMAL 


PLOT 


$FFFO 


65520 


Read/set X,Y cursor posi- 
tion 


RAMTAS 


$FF87 


65415 


Initialize RAM, allocate 
tape buffer, 3et screen 
S0400 


RDTIM 


$FFDE 


65502 


Read real time clock 


READST 


JFFB7 


65 4 A3 


Read I/O status ward 


RESTOR 


$FFSA 


65418 


Restore default \IO vectors 


SAVE 


SFFD8 


65496 


Save RAM to device 


SCNKEY 


SFF9F 


65439 


Scon keyboard 


SCREEN 


$FFED 


65517 


Return X,Y organization 
of screen 


SECOND 


$FF93 


65427 


Send secondary address 
after LISTEN 


SETLFS 


$FFBA 


65466 


Set logical, first, and sec- 
ond addresses 


SETM5G 


$FF9Q 


65424 


Control KERNAL messages 


SETNAM 


$FFBD 


65469 


Set file sane 


SETTIM 


tFFDB 


65499 


Set real time clock 


SETTMO 


$FFA2 


65442 


Set timeout on serial bus 


STOP 


$FFE1 


65505 


Sccsn stop key 


TALK 


$FFB4 


65460 


Command serial bus de- 
vice to TALK 


TKSA 


SFF96 


65430 


Send secondary address 
after TALK 


UDTIM 


$FFEA 


6551 4 


Increment real time clock 


UNLSN 


$FFAE 


65454 


Command serial bus to 
UN LISTEN 


UNTLK 


$FFAB 


65451 


Command serial bus to 

UNTALK 


VECTOR 


$FF8D 


65421 


Read/set vectored I/O 
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B-l. Function Name: ACPTR 



Purpose: Get data from the serial bus 
Call address; $FFA5 (hex) 65445 (decimal) 
Communication registers: .A 
Preparatory routines; TALK, TK5A 
Error returns: See READST 
Stack requirements: 13 
Registers affected: ,A, X 



Description: this is the rout ne to use when you want to get Informa- 
tion from a device on the serial bus. like a disk. This routine cjeti a byte 
of dnto o^f the serial bus using full handshaking. The data is returned in 
the accumulator. To prepare -for thij routine the TALK routine must be 
called first to command the device on "he serial bus to send data 
though the bus. H the input device needs a secondary ccnmand, it 
must bf> 5f>nt r>y using the TKSA KFRPJAl routine hefore cnlling this 
routine. Errors are 'etuned in the status word. The READST routine is 
used to read *he status word. 



How to Use: 

0) Command a device en the sericl bus to prepare to send data To 
the Comrnodo'e 64. (Use the TALK and TKSA KERNAL routines.) 

1) Call this routine (using JSR) 

2) Store or otherwise use the data. 



EXAMPLE; 

; GET A BYTE FROM THE BUS 
JSR ACPTR 

STA DATA 
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B-2. Function Name: CHKIN 

Purpose: Open a channel for input 

Call address: $FFCd (hex) 65478 (decimal) 

Communication registers: .X 

Prepcroto'y routines: (OPFN) 

Error returns; 

Stack requirements: None 

Regtslwrs affected: .A, .X 

Description: Any logical file that has already been opened by the 
KERNAL OPEN routine ran be defined as an input channel by this 
routine. Naturally, the device on the channel must be cm input device. 
Otherwise an eTcr will occur, and The routine will aborr. 

If you arc getting data from anywhere other than the keyboard., this 
routine must be called before using either ihe CHRIN or the GETIN KER- 
NAL routines for date input. If you want to use the input from the 
keyboard, and no other input channels are opened, then the tails to this 
routine, and to the OPEN routine ore not needed. 

When This routine is used with a device on the serial bus, it auto- 
matically sends the 1olk addret* (and the secondary address it one was 
specified by the OPEN routine) over the bus. 

Hew to Use; 

0) OPEN the logical file (if necessary; see description above). 

1) Load the .X register with number of the logical file to be used, 

2) Call this routine (using a JSR command), 

Possible errors are: 

#3: File not open 

#5; Device not present 

#6: Fie not an input file 

EXAMPLE: 

, PREPARE FOR INPUT FROM LOGICAL FILE 1 
LDX #2 
JSR CHKIN 
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B-3. Function Name: CHKOUT 

Purpose: Open a channel for output 

Call address: $FFC? (hex) 654B1 [decimal) 

Communication registers: .X 

Preparatory routines: (OPEN) 

Error returns; 0,3,5,7 (See READST) 

Stack requirements: 4 + 

Registers affected: .A, .X 

Description: Any logicul file number that has been created by the 
KERNAL routine OPEN can be defined sis an oulput channel. Of eojrse, 
the device you intend upeniny u chunnel to must be an output device. 
Otherwise an error will occur, and the routine will be aborted, 

This routine must be called before any dota is sent to any oulpul 
device unless you want to use the Commodore 64 screen as your output 
device, hf screen output is desired, and there are no other output chan- 
nels already defined, then calls to this routine, and to the OPEN routine 
are not reeded. 

When used to open a channel to □ device on the serial bus, this 
rou-ine will automatically send the LISTEN addross specified by the OPEN 

routine fond a secondary eddress if there was one]. 
How to Use; 

REMEMBER: th s routine is NOT NEEDED to seid data to the screen. 



0) Use the KERNAL OPEN routine to specify a logical file number, a 
I ISTFN ndriress, nnd a secondary address (if needed). 

1) Load the .X register with the logical file number used in the open 
statement. 

2) Call this routine (by using the JSR instruction). 

EXAMPLE: 

LDX #3 ;DEFINE LOGICAL FILE 3 A3 AN OUTPUT CHANNEL 

JSR CHKOUT 



Possible errors are: 

#3: File not open 

#5: Device not present 

#7; Not on output file 
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B-4. Function Name; CHRIN 

Pu-pose: Get a character from the inout channel 

Call address; $FFCF (hex] 65^87 (decimal) 

Communication reg sters: .A 

Preparatory routines.- (OPEN, CHKINj 

Frrar returns: [See READST) 

Stack requirements; 7+ 

Registers affected: .A, .X 



Description: This routine gets a byte of data -rom a channel already 
set up as the input channel by the KERNAL routine CHKIN. If the CHK1N 
has NOT been used to define another input channel, then all your data 
is expected from the keyboard, The data byte it returned in the ac- 
cumulator. The channe 1 remains open after the call. 

Input from the keyboard is handled in a special way. First, the cursor 
is turned on, and blinks until a carriage return is typed on the keyboard. 
All characters on the line (up to 88 characters) a r e stored in the BASIC 
input buffer. These characters can be retrieved one at a time by calling 
this routine once for each character. When the carriage return is re- 
trieved, the entire line has been processed. The next time this routine is 
called tne *hole p^oceis begins again, i.e., by flashing the cursor. 

Mow to Use: 

FROM THE KEYBOARD 

1) Retrieve a byte of data by calling this routine. 

2) Store the dota oyte. 

3) Check if it is the last data byte (is it a CR ?). 
A) If not, go tci step 1 . 



;PREPARE THE .Y REGISTER TO STORE THE DATA 

;5T0RE THE YTH DATA BYTE IN THE YTH 
LOCATION IN THE DATA AREA. 

,-i5 IT A CARRIAGE RETURN? 
;NO, GET ANOTHER DATA BYTE 
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EXAMPLE; 




LDY $#00 


RD 


J5R CHRIN 




STA DATA,Y 




INY 




CMP #CR 




BNE RD 



EXAMPLE: 

JSR CHRIN 
STA DATA 



FROM OTHER DEVICES 

0) Use the KENIMAL OPEN and CHKIN routines. 

1) Call I his routine (using o JSR instruction). 

2) Store the data. 

EXAMPLE: 

JSR CHRIN 
STA DATA 

B-5. Function Name: CHROUT 

Purpose: Output □ character 

Call add-ess: $FFD2 (hex) 65490 (decimal] 

Communication registers: .A 

Preparatory routines: (CHKOUT,OPENj 

Error returns: (See READST) 

Stock lequirem^nls: 8+ 

Registers affected: .A 

Description: Thii routine outputs a chnrarter to an already opened 
channel. Use the KERNAL OPEN and CHKOUT routines to ser up die 
outpu* channel before calling This routine. If this call ts omitted, data is 
sent to the default output device (number 3, the screen). The data byte 
to be output is focded into the accumulator, and this routine is called. 
The data is then sent to the specified output device. The chcnnel is left 
open after rhe call. 



MOTE; 
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using 
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ell opnn oi.tpiit 


chainsjb 


nn. the 


b 


IS 


JllfiSS 


this i& 


desir^c 


t alt opsn output channel* 


Tin the 


sprinl "ntp 


rtth^r -thn 


nth* in 


Ft 


in 


'■-'. -:\\"--\~ 


nntE^in 


rhnnnft 


must he cl&Mtcl hy ci mil 


10 the 


KFBNAI 


CIPCHN 


_ o uti n e 
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How to Use: 

0) Use the CHKOUT KERNAL routine if needed (see description 
above). 

1) Load the data to be oulput into the accumulator. 

2) Call this routine. 

EXAMPLE: 

;DUPUCATE THE BA5IC INSTRUCTION CMD 4, "A"; 

LDX #4 LOGICAL FILE #4 

JSR CHKOUT ;OPEN CHANNEL OUT 

L[>A #'A 

JSR CHROUT ; SEND CHARACTER 

B-6. Function Name: CIOJT 

Purpose: Transmit a byte over the serial bus 
Coll address; $FFA8 (hex; 65448 (decimal] 
Communication register*,: .A 
Preparatory routines; LISTEN, [SECOND] 
Error returns: See READST 

Stack requirements: 5 
Reyisters affected; Nont 

Description; This routine is used to send information to devices on the 
serial bus A col' to this routine will put a data byte onto the aerial bus 
Lsing -full serial handshaking. Before this routine is called, the LISTEN 
KERNAL murine must be used to command a device on the serial bus to 
get ready to receive data. [If a device needs a secondary address, it 
must also be sent by using the. SECOND KERNAL routine.) The ac- 
cumulator ts loaded with a byte to handshake as data or the serial bus. 
A device must he listening or the status word will return a timeout. This 
routine always buffers one character, (The rouiine hold* the previous 
character to be sent back.) So when a coll to the KERNAL UNLSN routine 
is made to end the data Transmission, the buffered character h sent 
with an End Or Identify (EOD set. Then the UNLSN nommnnd is sent to 
the device. 
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How to Use: 

0) Use the L'STEN KERNAL murine (and trip SFCOND routine if 

needed). 
1] Load the accumulator wflh □ byte of data. 
21 Call this routine to send the data byte, 

EXAMPLE: 



LDA #'X ,-SEND AN X TO THE SERIAL BUS 

JSR CSOUT 

B-7. Function Name; CINT 

Purpose; Initialize screen editor & 6567 video chip 
Calf address: $FF81 (hex) 65409 (decimal) 

Commurication, registers: None 
Preparatory ruulinei: None 
Error rstu'ris: None 
Stock requirements: 4 
Registers effected: .A, .X, .Y 

Description: This routine set* uo the 6567 video controller chip in the 
Commodore 64 for riormol operation. The KLRNAL screen editor is also 
initialized. This routine should be ca led by a Commodore 64 program 
cartridge. 

How to Use: 

1 j Ca I this routine. 

EXAMPLE: 

JSR CINT 

JMP RUN ;BEGIM EXECUTION 
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B-B. Function Name: CLALL 

Purpose: Close all files 

Call address: $FFE7 (hex) 6551 I (decimal) 

Communication registers: None 

Preparatory routines: None 
Error returns: None 
Stack require merits: 1 1 
Registers affected: .A, . X 

Description: This routine doses all open files. When this routine is 
called, the pointers into the open file table are reset, closing all files. 
Also, the CLRCHN routine Is ouromaTiccllv called tp reset the I/O chan- 
nels. 

How ro Use; 

1) Ceil I this routine. 

EXAMPLE: 

JSR CLALL ;CLOSE ALL FILES AND SELECT DEFAULT I/O CHANNELS 
JMP RUN ;BEGIN EXECUTION 

B-9. Function Name: CLOSE 

Purpose: Close a logical file 

Coll add -ess: $FFC3 (hex) &5475 (decimal) 

Communication registers; .A 

Prepuiuiuiy routines: Norte 

Error returns; 0,240 (See READST) 

Stack requirements: 2 + 

Registers affected: A, .X, ,Y 

Description: This routine is used to close o logicol file after all I/O 
operations huve been completed on that file. This routine is called after 
the accumulator is loaded with the logical file number to be closed [the 
sume number used when the file was opened using the OPEN routine). 
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How to List: 

1) Load the nccumulotcr with the number of the logical file to be 
closed. 

2) Call this re-urine. 

EXAMPLE: 

;CLOSE 15 
IDA #15 
JSR CLOSE 

B 10. Function Name: C1RCHN 

Purpose: Clear I/O channels 

Call addiass: $FFCC (hex) 65484 (decimylj 

Communication registers: None 

Preparatory re l, tines; None 

Error returns: 

Slutk requirements: 9 

Reg iters affected: .A, .X 

Description: This routine is colled to clear all open channels and re- 
store the I/O channels to their original default values. It is usually called 
cifter opening other I/O channels (like a tops o<- disk drive) and using 
them for input/output operations. The defaull input device is 
(keyboard). Tie default output device i= 3 {the CJommcdore 64 screen). 

If one of the channe.s to be closed s to the se'ial port, an UNTALK 
signal is sent first To cleat the input rhannel or nn UNI ISTEW is sent ta 
clear the output channel. By not calling this routine (and leaving lis- 
teners) active on The serial bus) several devices can receive the srime 
data from the Commodore 64 at the same time. One way to lake ad- 
vantage of this would be ro command the printer to TALK nnd tn= disk To 
LISTEN, This would allow direct printing of a d sk tile. 

This routine is automaTically colled when the KERNAL CLALL routine is 
executed. 

How to Use: 

1) Call this routine using the JSR instruction. 
EXAMPLE: 
JSR CLRCHN 
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B-11. Function Name; GETIN 



Purpose: Get a character 
Call address: $FFE4 (hex) 65508 (decimol) 
Curirriuriicarion registers: .A 
Preparatory routines: CHKIN, OPEN 

Error returns: See READST 
Stock requirement!;: 74- 
Registers effected; .A i.X, .Y] 



Description: If rhe channel is The keyboard, this subroutine removes 
on© character from the keyboard queue old returns it as an ASCII value 
in the accumulator. If the queue is empty, the value returned In the 
accumulator will be zero. Characters aro put into the queue ajto- 
maticoliy by an Interrupt driven keyboard scar routine which calls the 
SCNKEY routine. The keyboard buffer can hold up to ten characters. 
After the buffer is filled, additional characters are igno'ed until at least 
one characte' has been removed from the queue. If the channel is RS- 
232, -hen crly the .A register is used and a single character is returned. 
See READST to check validity. If the channel is serial, cassette, or 
screen, call DAS N routine. 



How fa Use: 

1) Coll this routine usirg a JSR instruction. 

1] Check for a 7ere in the ner urn u Into' (smrvy hi.ffpr). 

3) Process the data. 



EXAMPLE: 

,-WAIT FOR A CHARACTER 
WAIT JSR GETIN 
OrfP #0 
BEQ WAIT 
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B-12. Function Nome: lOBASE 

Purpose: Define I/O memory page 

Cafl address; $FFF3 (hex) 65523 fdeumal) 

Comrriu nicotian registers: .X, .Y 

Preparatory -Qutiries; None 

Error returns: 

Stack requirements: 2 

Registers affer-ted: .X, .Y 



Description: This routine Sets the X and Y registers to the address of 
the memory section where the memory mapped I/O devices are located. 
This address cat then be used with on offset to access the memory 
mopped I/O devices in the Commodore 64. The offset is the number of 
locations from the beginning of the page on which the I/O register you 
wort is lorated. The .X register contains the low order address byte, 
while the ,Y register contains the high order address byte. 

This routine exists to provide comoatibillty hetween the Commodore 
64, VIC-2Q, and f jture models of the Commodore 64. If the I/O locations 
for a machine longuage program are iet by a call fn this routine, they 
should still remain compatible with Future versions of the Commodore 
64, the KERNAi and BASIC. 



How to Use: 

15 Call this routine by using the JSR Instruction, 

2) Store the .X and the -Y registers in consecutive locations. 

3) Load tne .Y register with the offset, 
4J Access that I/O location. 



EXAMPLE; 

; SET THE DATA DIRECTION REGISTER OF THE USER PORT TO 0(1 N PUT) 

JSR lOBASE 

STX POINT ? 5ET BASE REGISTERS 

STY POINT+1 

LDY #2 

LDA #0 ,-OffSET FOR DDR OF THE USER PORT 

STA (POINT), Y ;SET DDR TO 
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S-I3. Function Name: rOINIT 

Purpose: Initialize l/Q devices 

Call Address; $FF84 (hex) 65412 (decimal) 

Comrnunicction registers: None 

Preparatory routines; None 

Error returns: 

Sluck requirements; None 

Registers affected: -A, ,X f .Y 

Description: This rou'rne initiates all fnput/outpur devices and 
'outines. It is normally called as pari of the initialization procedure of a 
Commodore 64 program cartridge. 

EXAMPLE: 

JSR IOINIT 



B-I4. Function Name: LISTEN 

Purpose: Command a device or the serial bus to listen 

Cal Address: $FFBT (hex) 65457 (decimaij 

Cemmimicntior. registws; .A 

Preparatory routines; None 

E'ror returns: See READST 

Stack requirements: Non$ 

Registers affected; -A 

Description: This routine will command a device on the serial bus to 
receive data. The accumulator must be loaded with a device numoer 
between and 31 before colling the routine. LISTEN will OR the nurnoer 

bit by bit to convert to a listen address, then transmits this data as a 
command on the serial bus. The specified device wil then go into listen 
mode, and be ready to accept information. 

How to Use: 

1) Lead the accumulator with ihe number of the device to command 
To JSTEN. 

2) Call this routine using the JSR instruction. 

EXAMPLE; 

,-COMMAND DEVICE #8 TO LISTEN 
LDA #8 
JSR LISTEN 
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B-15. Function Name: LOAD 



Purpose; Load RAM from device 

Call address: $FFD5 (h»x) 65493 (decimal) 

Communication registers; .A^X^Y 

Preparatory routines: SETLFS, SETNAM 

Error returns: 0,4,5,8,9, READST 

Stack requirements: None 

Registers affected; .A, .X, .Y 



Description: This routine LOADs data bytes from any input device di- 
rectly into the memory of me Commodore 64, It can also be used for a 
verify operation, comparing data from a device with the dcita already in 
memory, while leaving the data stored in RAM unchanged , 

The accumulator (.A' must be set TO Ofor a LOAD operation, or 1 for a 
verify. If the input device is OPENed with a secondary addres3 (SA) of 
the header information from the device is ignored. In This case, the .X 
nnri Y registers musf certain the starting address fo' the load. If the 
cevice is addressed with a secoitdu'y address cf 1, then the data is 
loaded "rto memory starting at the location specified by the header. Thig 
routine returns the eddress of the hiuhesl RAM lecation loaded. 

Before this routine can be called, tie KERNAL SETLFS, and SETNAM 
routines musl be called. 



MOTE; roL can NOT LOAD fom the keyboard (0), R5-232 (2), or (he screen (31. 



How to Use: 

0) Call the SETLFS, and SETNAM routines. If a relocated load is de- 
sired, use the SETLFS routine to send c secondary address of 0. 

1) Set the ,A register to for load, I for verify, 

2) If a relocated load is desired, the .X and .Y registers rrust be set 
to the start eddress for the load. 

3) Cull the routine using the JSR Instruction. 

2SA basic ro machine lanquaoc 



EXAMPLE: 



ilOAD A FILE FROM TAPE 

IDA #DEV1CE1 

LDX #FILENO 

LDY CMD1 

JSR SETLFS 

LDA #NAME1-NAME 

LDX #<NAME 



;5ET DEVICE NUMBER 

;SET LOGICAL FILE NUMBER 

;5ET SECONDARY ADDRESS 

;LOAD .A WITH NUMBER OF 
;CHARACTEftS IN FILE NAME 
;LOAD .X AND .Y WITH 
;ADDRESS OF 





LDY 


#>NAME 


jFILE NAME 




JSR 


SETNAM 






LDA 


#0 


;SET FLAG FOR A LOAD 




LDX 


MFF 


ALTERNATE START 




LDY 


#$FF 






JSR 


LOAD 






STX 


VARTAB 


;END OF LOAD 




STY 


VARTAB + 1 






JMP 


START 




NAME 


,BYT 


'FILE NAME' 




NAME ] 


r 







B-16. Function Nome: MEMBOT 

Purpose; Set bat*om of memory 

Call address- $FF9C (hex) 65436 [decimal) 

Communication registers: .X,.Y 

Preparatory routines: None 

tr-or returns? None 

Static requirements: None 

Registers affected: -X, ,Y 

Description: This routine is used to set the bottom of the memory. If 
the accumulator carry bil is set when this, routine is called, a pointer to 
the lowest byte of RAM is returned [n the .X and .Y registers. On the 
unexpended Commodore A4 the initio! i/alue of this pointer is $0300 

(2048 in decimal;. If -he accumulator carry bit is clear (=0) when this 
routine is coiled, the volties of the .X and .Y registers are transferred to 
the low and. high bytes, respectively, of the pointer to the beginning of 
SAM, 
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How to Use: 

TO READ THE BOTTOM OF RAM 
I ) Set the carry. 
2j Call this routine. 

TO SET THE BOTTOM OF MEMORY 
1] Cfear the ccrry. 
2] Call this routine. 

EXAMPLE: 

; MOVE BOTTOM OF MEMORY UP 1 PAGE 

SEC ;READ MEMORY BOTTOM 

JSR MEMBOT 

INY 

CLC ;SET MEMORY BOTTOM TO NEW WUE 

JSR MEMBOT 

B-17. Function Name: MEMTOP 

Purpose: Ssst the top of RAM 

Call address: $FF?9 (hex) 65433 (decimal) 

Communication registers: .X, .Y 

Preparatory routines; Hone 

Error returns: None 

Stock requirements: 2 

Registers effected: X, .Y 

DeStriprion: This murine is used to set the top of RAM. When this 
routine is called with the carry b t of the accumulator 5et, the ooiriter to 
the top of RAM will be loaded into ihe .X and .Y registers. When this 
routine is called with the accumulator carry bit clear, the contents of the 
.X and .Y registers are loaded in ihe top of memory pointer, charging 
the top of men-iory. 

EXAMPLE: 

;DEAL10CATE THE RS-232 BUFFER 

SEC 

JSR MEMTOP ;READ TOP OF MEMORY 

DEX 

CLC 

JSR MEMTOP ;SET NEW TOP OF MEMORY 
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B-18. Function Name; OPEN 

Purpose; Open a logical file 
Call address: $FFC0 (hex) 45^72 (decimal 
Comrrunicotion reg sters: None 
Prepet-atcry routines: SERFS, SETNAM 
Error returns: 1,2,4,5,6,240. READST 
Stock requirements: None 

Registers affected: .A, .X, .Y 



Description: This routine is used to OPEN a logical file. Once 'the logi- 
cal file is set up, it can he used far input/output operations. Most of the 
I/O KERNAL routines call on this routine to create the logical files to 
operate on. No arguments need to be set up to use this routine, bu1 both 
the SETLFS and SETNAM XCRNAL routines must be called before using 
this routine. 

Hew to Use: 

0) Use the SETLFS routine. 

1) Use the 5ETNAAA rouline. 

2) Call this routine. 

EXAMPLE: 

This is an implementation of the BASIC statement: OPEN 1 5,8, 15,"l/ O" 





LDA #NAME2-NAME 




LDY #>NAME 




LDX #<NAME 




JSR SETNAM 




LDA #15 




LDX #8 




LDY #15 




JSR SETLFS 




JSR OPEN 


NAME 


.BYT 'I/O' 


NAME 2 





;LENGTH OF FILE NAME FOR SETLFS 
ADDRESS OF FILE NAME 
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B-19. Function Name: PLOT 



Purpose: Set curso' location 

Call address: $FFF0 (hex) 65520 (decimal) 

Communication ■"egisters: .A, .X, .Y 

Preparatory routines: None 

Error returns; None 

Stack requirements: 2 

Registers affected: .A, .X, .Y 



Description: A call to this routine with the accumulator carry flag set 
loads the current position of the cursor on the screen (in X,Y coordinate*} 
into the .Y and .X registers. Y is the column number cf the cursor location 
(6-39L and X is the row nunber of the location cf the cursor CO-24). A 
call witn the carry bit clear moves the cursor to X,Y as determined by 
ihe .Y und X reyislers, 



How to Use: 

READING CURSOR LOCATION 

1) Set the corry flag. 

2) Call this routine, 

3; Get -he X and Y position frorr -he ,Y and .X registers, respectively. 

SETTING CURSOR LOCATION 
1 J Clear carry flag, 

2} Set the Y and _X registprs to rh*s rtesireH cursor location, 
3] Coll this routine. 



EXAMPLE: 

, WOVE THE CURSOR TO ROW 10, COLUMN 5 (5,10) 
LDX #10 

LDY #5 

CLC 

JSR PLOT 
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B-2Q. Function Name: RAMTAS 

Purpose: Perform RAM test 

Call address: 5,FF87 (hex) 65415 (decimal) 

CommunicOtion registers: .A., ,X, .Y 

Prepurutory routines: None 

Error returns: None 

Stack requirements: 2 
Registers affected: ,A, .X, .Y 

Description; This routine is used to test RAM and set the top and 
bofam of memory pointers cicccrriingly. It also dears locations $0000 to 
tOlOl ond t0200ta |03FF, It also allocates tne cassette buffer, and sets 
the screen hose to $0400. Normally, ihis murine is called as part of tne 
initialization process of a Commodore 64 program cartridge, 

EXAMPLE: 

JSR RAMTAS 

B-21. Function Name: RDTIM 

Puroc.se; Reud syslBm tlouk 

Call address: SFFDb (hex) 65502 (decimal) 

Communication registers: .A, .X, .Y 

Preparatory rojtines: None 

Error returns; None 

Stack recui'e merits: 1 

Registers affected; .A, .X, .Y 

Description: This routine s used to read the System clock. The clock's 
resolution is n 60th of c. second. Three bytes are returned by rhe routine. 
The accumulator contains the most significant byte, the X index register 
contains the next most significant byte, and the Y index regis'er contains 
the least significant oyte. 

EXAMPLE: 

JSR RDTIM 
STY TIME 

STXTIME+1 
STA TIME + 2 

TIME *-*+3 
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B-22. Function Name: READST 



Purpose; Read status word 

Ca'l address; SFFB7" (hex) 65463 (decimal) 

Communication registers: ■* 

Preparatory routires: None 

Error returns: None 

Stack requirements: 2 

Registers affected: >" 



Description: This routine returns the current sta+us of the I/O devices in 
the accumulator. The routine is usually called after new communication 
to gn I/O device. The routine gives you information about device status, 
or errors thot have occurred during the MO operation. 

The bits returned in the accumulator contain the fulluwiny information: 
(see table below) 



ST 


ST 






TAPE 


BIT 


NUMERIC 


CASSETTE 


SERIAL RW 


VERIFY 


POSITION 


VALUE 


READ 




+ LOAD 





' 




Time out 

write 




1 


2 




Time out 
read 




2 


& 


-Short block 




Short bJock 


3 


8 


Long block 




Long block 


4 


16 


Unrecoverable 
read error 




Any 

mismatch 


5 


32 


Checksum 
error 




Checksum 
error 


6 


64 


End of file 


FOI line 




7 


-128 


End of tape 


Device not 
present 


End of 
tape 
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How to Use: 

" ) Call this rojtine. 

2) Decode the information In the .A register as i1 refers to your pro 
gram. 

EXAMPLE: 

,-CHECK FOR END OF FILE DURING READ 

JSR READST 

AMD #5.4 (CHECK EOF BIT {EOF = END OF FILE) 

BNE EOF /BRANCH ON EOF 

B-23. Function Name: RESTOR 

Purpose: Restore default system and interrupt vectors 
Call address: $FF8A (hex) 65418 (decimal) 
Preparatory routines: None 
Error returns- None 
Stack requirements: 2 
Registers affected: j^. p x, .Y 

Description: This routine restore^ the default valijss of all- system vec- 
tors used in KERNALand BASIC routines and interrupts. [See the Memory 
Map for the default veclor contents). The KERNAL VfcCIOK routine is 
used to read and alter individual system vectors. 

How to Use: 

1) Call this routine. 
EXAMPLE: 
JSR RESTOR 

B-24. Function Name: SWE 

Purpose Sovc memory to a device 

Call cddress: $FFD8 (hex) 65496 (decimul) 

Lommnnirotirn registers: , A,.X,.Y 

Preparatory routines SETLFS. SETNAM 

Error returns 5,B,Q. READST 

Stack requirements. None 

Registers affected: .A, .X, .Y 
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Description: This routine saves a section of memory. Memory is saved 
from an indirect address on page specified by the accumulator to the 

address stared n the .X end .Y registers. It is then sent to a logical file 

cn on input/output device. The SETLFS and SETNAM routines must be 
used before cal'ing this routine. However, a file name is not required to 
SAVE to device 1 (the Datassette™ recorder). Any attempt to save to 
other devices without using a file name results in an error. 



NOTE: Device (rhe keyboard), device 2 (3S-232), end device 3 (the screen' tonnol 
b& SWEd to. It the aftetlpt i? -nade, on error occurs, and the SWE u stopped. 



How to Use: 

0) Use rhe SETLFS routine and rhe SETNAM routine (unless a SAVE with 
no file name is desired on "o save to the tape recorder"). 

1) Load twe ccrsecurive location:? on page with a pointer to the 
start of your save (in standard 6502 lew bylo first, high byte next 
format). 

2) Load the accumulator with the single byte page zero offset to the 
pointer, 

3) Load the ,X and .Y registers with the low byte and high byte re- 
spectively cf the loca-ion of the end of the save. 

4) Coll this routine 

EXAMPLE: 



LDA #1 
JSR SETLFS 
LDA #0 
JSR SETNAM 
LDA PROG 
STA TXTTAB 
LDA PROG+1 
STA TXTTAB -1 
LDX WRTAB 
LDY\ARTAB + 1 
LDA #<TXTTA8 
JSR SAVE 



;DEVICE-1 CASSETTE 

;NO FILE NAME 

;LOAD START ADDRESS OF SAVE 
; (LOW BYTE) 

; (HIGH BYTE) 

,-LOAD .X WITH LOW BYTE OF END OF SAVE 

,-LOAD .Y WITH HIGH BYTE 

;LOAD ACCUMULATOH WITH PAGE OFFSET 
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B-25. Function Name; SCNKEY 

Purpose: Scan the keyboard 

Call address: $FF°F (hex) 65439 (decimal) 

Corrimuriicatfan registers: None 

Preparatory routines: 101 N IT 

Error returns: None 

Stack reqi/remcmsr 5 

Registers affected: .A, .X, Y 

Description; This routine scans the Commodore 6^ keyboard and 
checks for pressed keys. Il ii the same raul'ne culled by the inter.up' 
handler. If a key s down, its ASCII value is placed in the keyboard 
queue. This routine is called only if the normal IRQ interrupt is bypassed. 

Haw to Use: 

1) Coll this routine 
EXAMPLE; 

GET JSR SCNKEY ;$CAN KEYBOARD 

JSR GETIN ;GfcT CHARACTER 

CMP #0 ;IS IT NULL? 

BEQ GET rYES . . . SCAN AGAIN 

JSR CHROUT ;PRINT IT 

B-26. Function Name: SCREEN 

Purpose; Re*um screen format 

Call address: $FFED (hex) 65517 (decimal) 

Communication registers; ,X,.Y 

Preparatory routines: None 

Stack requirements: 2 

Registers affected: ,x, .Y 

Description- This routine relurns the format of the screen, e.g., 40 
columns, "n .X and 25 lines in ,Y. The outine can be used to determine 
what machine a program it running on. This function has been im- 
plemented an the Commodore 64 lu help upward LompLililjilily of your 
programs. 
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How to Use: 

I) Coll this, routine. 
EXAMPLE: 

JSR SCREEN 
STX. MAXCOL 
STY MAXROW 

B-27. Function Nome: SECOND 

Pj pose; Send secondary address for LISTEN 

Call address: $FP?3 (hex) 65427 (decimal) 

Communication registers: ,A 

Preparatory routines: LISTEN 

Error returns; See READST 

Stack requirements: 3 

Registers affected: .A 

Description; This routine is used to send a secondary address to an 
I/O device after a coll to the JS7EN routine is made, and the device is 
commanded to LISTEN. The reufne canNOT be used to scad a second 
ary address after a call to the TALK routine. 

A secondary address is usually used to give setup information to a 
device before I/O operations begin, 

When a secondary address is to be sent to a device on the serial bus, 
the address must first be ORed with $60. 

How ta Use: 

1) Lcod the accumulator w'th lie secandury address to be sent. 

2) Call this routine. 

EXAMPLE: 

,-ADDRESS DEVICE #8 WITH COMMAND (SECONDARY ADDRESS) #15 
IDA #8 
JSR LISTEN 
LDA #15 
JSR SECOND 
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B-28. Function Name: SETLFS 

Purpose: Set up a iofjica file 

Coll address: $FFBA (hex) 65466 (decimal) 

Coirmuni cation registers: -A, .X, ,Y 
Preparatory routines- None 
Error returns: None 
Stack requirements: 2 
Registers affected: None 

Description: This routine sets the logical file number, device address, 
and secondary address [command number) for other KERIMAL routines. 

The logical fl e number is used by the system eis a key to the file table 
created by the OPCN file routine. Device addresses can range from to 
31. The following codes are used by the Commodore 64 to stand for the 
CBAfl devices listed below: 



ADDRESS 


DEVICE 





Keyboard 


1 


Datassette™ #1 


2 


RS-232C device 


3 


CRT display 


A 


Serial bus printer 


8 


CBM serial bus disk drive 



Device numbers 4 or g r eater automatically refer to devices on the 
serial bus, 

A command to tne device is sent as a secondary address on the serial 
bus after the device number is Sent during the Serial attention handshak- 
ing sequence. If no secondary address is to oe sent, the .Y index regis- 
ter shou d be set 1o 255. 

Haw to Use: 

1) Load the accumulator with the logical file number. 

2) Load the .X ndex register with the device number, 

3) Load the ,V index register with the command. 
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EXAMPLE: 

FOR LOGICAL FILE 32, DEVICE #4, AND NO COMMAND: 
LDA #32 
LDX #4 
LDY #255 
JSR SETLFS 



B-29. Function Nome: SETMSG 

Purpose: Control system message output 
Call address: $FF90 (hex) 65424 [decimal) 
Communication registers: ,A 
Preparatory routines: None 
Error returns: None 
Stack requirements; 2 
Registers affected: A 



Description: This routine control; the prmliny t>[ error uid control mes- 
sages by tho KERNAL. Either print &rror Tie&soges or print control mes- 
sages can be selected by setting the accumulator when the routine h 
called. FILE NOT FOUND is an example of an error message. PRESS 
PLAY ON CASSETTE h en example of a control message. 

Bits 6 and 7 of this value determine where the message will come 
front* . If bit 7 is 1 , one of the error messages from the KEftfJAL is printed. 
If bit 6 is set, control messages are printed. 

Hew to Use: 

1) Set accumulator to desired value. 

2) Call this routine, 

EXAMPLE: 

LDA #$40 

JSR SETMSG jTURN ON CONTROL MESSAGES 

LDA #$80 

JSR SETMSG JURN ON ERROR MESSAGES 

LDA #0 

JSR SETMSG ,TURN OFF ALL KERNAL MESSAGES 
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a-30. Function Name: SETNAM 

Purpuse: Set up file name 

Call address: SFFBD [hex) 65469 (decimal) 

Conirnumculiuri registers: .A< .X, .Y 

Preparatory routines: None 

Stack requirements: None 

RegUlers affected: Nona 

Description: This routine is used to set up the file name for the OPEN, 
SAVE, or LOAD routines, T he accumulator must be loaded with the 
length of the file name The X and ,Y reg'sters must be landed with the 
address of the fi e ncme, in standard 6502 low- byte' high byte format. 
The address can be tiny valid memory address in the system where a 
siring of cliuiuLltrs for the file name is stored, ft no file name is desirec, 
the accumulator must he spt tr> 0, rep r esenting a zero file length. The .X 
and .V registers car be set to any memory address in thct case. 

How to Use: 

1) InaH the accumulator with the length of the file name. 

2) Load the ,X index 'egister with the low order address of the file 
name. 

3) Load the .Y index register with the nigh order address. 

4) Tnll this routine. 

EXAMPLE: 

LDA #NAME2-NAME ;LOAD LENGTH OF FILE NAME 

LDX #<NAME ;L0AD ADDRESS OF FILE NAME 

LDY #>NAME 
JSR SETNAM 



B-31. Function Name: SETTIM 

Purpose: Set the system clock 

Call nddress: $FFD3 (hex) 65499 [decimal) 

Communication registers; -A, .X, . V 

Preparatory routines: None 
Error returns: None 
Stack requirements- 2 
Registers affected; None 
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Description: A system clock Is maintained by an interrupt routine that 
updates the clock every l/60+h of a second (one "jiffy"). The clock is 
three bytes long, which gives it the capability to count up to 5,184,000 
jiffies 124 hours]. At that point the clock resets to zero. Before calling this 
routine to set the dock, the accumulator rnusi contain the mast 
significant byte, the .X index register the next most significant byte, and 
the .Y index register the least significant byte of the Initial time setting 
(in jiffies). 
How to Use: 

1) Lucid the accumulator with the MSB of the 3-byte number to set the 

clock. 
2] Load the .X register with the next byte. 

3) Load the Y roister with the LSB. 

4) Call this routine. 

EXAMPLE: 

;SET THE CLOCK TO 10 MINUTES = 3600 JIFFIES 
IDA #0 ; MOST SIGNIFICANT 

LDX #>3600 

LDY #<36O0 ; LEAST SIGNIFICANT 

JSft SETTIM 

B-32. Function Name: SETTMO 

Purpose: Set IEEE bus card timeout fag 
Call address: $FFA2 (hex) (,5442 (decimal) 
Communication registers: ,A 
Preparatory co urines: None 
Error retu'ns: None 
Stack requirements: 2 
Registers effected: None 



NOTE: [his routine is used ONLY with or IEEE add-on i-ard! 



Description; This routine sets the timeout flag for the IEEE bus. When 
the timeout flag is set, the Commodore 64 will wait for a device on the 
IEEE port for 64 milliseconds. If tbe device does not respond to the 
Commodore 64's Data Address Valid (ft^W) Signal within that time the 
Commodore 64 will recognize an error condition and leave the hand- 
shake sequence. When thte routine is called when the accumulator con- 
tains c in bit 7, timeouts are enabled, A 1 in bit 7 will disable the 
timeouts. 
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MOTE: The Commodore 64 ujea the timeout feature to communicate that a disk file is 
not found' on ar artempt- to OPEN a file only with an IEEE tcrd. 



How to Use; 

TO SET THE TIMEOUl HAG 

1) Set bit 7 of the accumulator to 0, 

2) Call this routine. 

TO BESE1 IHt IIMbOUT FLAG 

1) Set bit 7 of the accumulator to 1 . 

2) Call this routine. 

EXAMPLE: 

,-DISABLE TIMEOUT 
IDA #0 
JSR SETTMO 

B-33. Function Name: STOP 



Purpose: Check if QQ3 key is pressed 
Call address: $FFE1 (hex) 65505 (decimal) 
ComiTiuiiiuaticin registers; .A 
Prepa'atcry routine*: None 
Error returns: None 
Stack requirement*: Ncne 
Registers affected: -A, .X 

Description: If the ^^ key on the keyboard was pressed during 
a UDTIM call, this call returrs the Z flag set. In addition, the channels 
will be reset to default values. All other flags remain unchanged, If 
the B"! key is not pressed then the accumulator will contain a byte 
representing the last row of the keyboard icon. The user can also check 
for ;ertain olher keys this way. 

How to Use: 

0) UOTIM should be called before this routine. 

1 ) Call this routine. 

2) Test for the zero flag. 
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EXAMPLE: 

JSR UDTIM ;SCAN FOR STOP 
JSR STOP 

BNE *+5 ;KEY NOT DOWN 
JMP KEADY ,-=... STOP 

B-34. Function Name: TALK 

Purpose; Command a device on the serial bos to TALK 

Call address: $FFB4 [hex) 65460 (decimal) 

Communication registers: A 

Preparatory routines: None 

Error returns: See READST 

Stack requirements: 8 

Registers sffecTed: A 

Description: To u3e ^' s routine t^e accumulator must first be loaded 
with a device number between and 31 . When called, Th's routine Then 
ORs bit by bil to convert this device numbcf to a talk address. Then this 
data is Transmitted as a command an trie serial bus. 

Haw to Use: 

1) Load the accumulator with the device number. 
7) Cal' this 'ouTine, 

EXAMPLE: 

;COMMAND DEVICE #4 TO TALK 
IDA #4 
JSR TALK 

B-35. Function Name: TKSA 

Purr>nse»: Send a setondurv address lo u device tommonded to TALK 

Call address: $FF96 (hex> 45430 (decimal) 

Communication registers: -A 

Preparatory routines: TALK 

Error returns: See READST 

Stack requirements: 8 

Registers affected; -A 
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Description: This routine transmits a secondary address on the serial 
bus for a TALK device. This routine must be called with a number be- 
tween and 31 in -the accumulator. The routine sends this nutiber ce a 
secondary address command oyer the serial bus. This routine can only 
■>e called after a call to -he TALK routine. It will not work after a LISTEN. 

How to Use: 

0} Use the TALK routine. 

1) Load the accumulator with the secondary eddrcss. 

2) Call this routine. 

EXAMPLE: 

;TELL DEVICE #4 TO TALK WITH COMMAND #7 
LDA 4A 
JSR TALK 
LDA #7 
JSR TALKSA 

B-36. Function Name; UDTIM 

Pu'pose: Update the system dui.k 

Call address: $FFEA (hex; 655 Id (decimal) 

Comtnuriicatian registers: None 

Preparcilar/ routines: Nore 

Error returns; None 

Stock requirements: 2 

Registers effeced: .A f .X 

Description: This routine updates the system clock, Normally this 
routine fs called by the normal KERNAL interrupt routine every l/60th of 
a second. H the user program processes its own "rtsrrupts this routine 
must be called to update the 1im*i. In addition, the ! > key routine 

must be colled, ff the WfJ key is to remcin functional. 

How to Use: 

1) Call this routine. 
EXAMPLE: 

JSR UDTIM 
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B-37. Function Name: UNLSN 

Purpose: Send an UNLISTEN command 
Call address: $FFAE [hex) 65454 (decimal) 
Communication registers: Nnnp 
Preparatory routines: None 
Error returns: See READST 
Stack requirements: 8 

Registers affectec: .A 

Description: This routine commands all devices on the serial bus to 

stop receiving data from the Commodore 64 [I.e., UNLISTEN). Calling 
this routine results in an UNLISTEN command being transmitted on the 
serial bus. Orly devices previously commanded to listen are a'Hected. 
This routine is normally used after the Commodore 64 is finished sending 
data ta external devices. Sending the UNLISTEN commands the listening 
devices ^o get off the seria bus so it can he used for oilier purposes. 

How to Use: 

Ij Call this routine. 

EXAMPLE: 

JSR UNLSN 

B-38 Function Name: UNTLK 

Purpose: Send en UNTALK corn mono 

Call address; $FFAB (hex) 65451 (decimal) 

Communication registers: None 

Preparatory routines: None 

Frmr returns: ISee ktADST 

Stack requirements: 8 

Registers affected: .A 

Description: This routine transmits an UNTAI K coimmnnri an the ssrinl 
bus. All devices previously set to TALK will stop sending data when this 
corrmrind is rprpived. 

How to Use: 

1 ) Call this routine. 
EXAMPLE: 
JSR UNTALK 
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B-39. Function Nome: VECTOR 



Purpose: Manage RAM vectors 

Call address: $FFSD (hex] 65421 (decimal) 

Communication regis-ers: .X,,Y 

Preparatory raiiT'nes: None 

Error returns; None 

Stack requiremems: 2 

Registers af-ected: A, .X, .Y 



Description: This routine mgnqges all system vector jump addresses 
stored in RAM. Calling this routine with the the accuinululor curry *jit set 
stores rhe current contents of the RAM vectors in a list pointed to by the 

.X and .V registers. When this routine is called with the carry clar, the 
user list pointed to by the X and Y registers is transferred ~o the system 
RAM vectors. The RAM vector* ore listed In the memory map. 



NOTE: This rautfne requires caution in Ms use. The best jvay to use it n 1o first read the 
entire vecto" contents into trie jier crea, alter trie desired vectors, and "hen copy the 
contents back to the system vectors. 



How to Use; 

RtALl I HE SYSTEM RAM VECTORS 

1) Set the carry. 

2) Set the .X and .y registers to the address to put the vectors. 

3) Call this routine. 



lOAD THE SYSTEM RAW VbCIQHS 

1) Clear the ccrry bit. 

2) Set the .X end Y registers to the address of the vector list in RAM 
that most ce loaded, 

3) Call this routine, 
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EXAMPLE: 



;READ OLD VECTORS 
;CHANGE INPUT 



;CHAWGE THE INPUT ROUTINES TO NEW SYSTEM 

LDX #<USER 

LDY #>U5ER 

SEC 

JSR VECTOR 

IDA #<AVKINP 

STA USER+10 

LDA #>MYINP 

STA USER+11 

LDX #<U5ER 

LDY #>USER 

CLC 

JSR VECTOR ;AITER SYSTEM 



USER *=* + 26 

ERROR CODES 

The following is a list of error messnges which nn occur when using 
the KERNAL routines. If an error occurs during a KERNAL routine,, the 
car'y hit of the accumulator is set, and the number of the error message 

is returned in the accumulator. 



MQTt Sonc KERNAL I/O rojlincs do not use thcss csdes for error rresscges. Inslecjd, 
errors ars identfied using -the KERNAL READST icu-ine. 



NUMBER 


MEANING 




1 


Routine terminated by the | ^ key 
Too many epen files 




2 


File already open 




3 


File not open 




4 


File not found 




5 


Device not present 




6 


File s not an input file 




7 


File is not arr output file 




8 


File name is missing 




9 


Illegal device number 




240 


Top-of-merrory change RS-232 buffer a 


ocation/deallocaiion 



306 



EASIC TU MALHiNt LANGUAGE 



USING MACHINE LANGUAGE FROM BASIC 

There are several methods of using BASIC and muchine language on 
The Cnrnmndore 64, including special statements as part of CBM 3ASIC 
OS well as key locations in the machine. There are five main way* to use 
machine language routines from BASIC on the Commodore 64, They 
ore: 

1) The BASIC SYS statement 

2) The 3A5IC USR function 

3) Changing one of ihe RAW \IO vectors 

4J Changing one of the RAM inter-opt vectors 

5) Changing the CHRGET routine 

1) The BASIC statement SYS X causes a JUMP to a machine language 
subroutine located at address X. The routine must and with an RTS 
(ReTurn from Subroutine) instrudiun. This will irursTe" control back 
to BASIC. 

Parameters are generally passed between the machine lan- 
guage routine and the BASIC program using the BASIC PEEK and 
POKE statements, and their machine language equivalents. 

The SYS commond is the most useful method of combining 
BASIC with machine language. PEEKs and ^OKEs nake multiple 
parameter passing easy. There can be many SYS statements in a 
program, each to a different (or even the same) machine lan- 
guage routine. 

2) The BASIC "unction USR(X) transfers control ro the machine lan- 
guage subroutine located at the address stored in locations 785 
and 7B6. (The address is stored in stundurd low- byte/ high- byte 
format.) The value X is evaluated and passed to the machine lan- 
guage subroutine through fleeting point accumulate! #1, lucoied 
begirnincj at address $61 (see memory map for more details). A 
value may be returned beck to the BASIC program by placing It in 
the floating ooint accumulator. The machine language routine must 
end with an RTS instruction to return to BASIC. 

This staremert is diffetenTfraii the SYS, because you have to set 

up an indrect vector, Abo different is "he format through which 
the variable is passed (floating paint format). The indirect vector 
must be changed if more than one rmach re language routine is 

u=ed . 
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3) Any of the inpui/output or BASIC intend routines accessed through 
the vector table located on page 3 (see ADDRESSING MODES, 
ZERO PAGE) can be replaced, or amended by user code. Each 
2-byte vector consists ot a lew byte and a high byre aodress which 
15 used by the operating system. 

The KERMAL VECTOR routine Is the most reliable way to change 
any of "he vectors, but o single vector can be changed by POKEs. 
A new vector will point to a user prepared routine which is meant 
la replace or augment the standard system routine. When the ap- 
propriate BASIC command is executed, the user routine will be 
execuled. If tiller e-xeculir y tile user rcctine, it is necessary to exe- 
cute the norrnol System routine, the user program must JMP (JuMP; 
to the eddress formerly tonlained in the vector. H nut, ihe ruuline 
must end wth o HIS to transfer control bock to BASIC. 

4) The HARDWARE INTERRUPT (IRQ) VECTOR can be changed. Every 
l/60th of c second, the operating system transfers control to the 
routine specified by this vector. The K[ftNAL normally uses this for 
timing, keyboard scanning, etc. If this technique is used, you 
should always transfer control to the normal IRQ handling routine, 
unless the replnrpment routine is prepared to handle the CIA chip. 
(REMEMBER to end the ro'J-he with od RTI (ReTurn from Interrupt) 
if the CIA is handled by the routine). 

This method is jseful for tasks which must hapoen concurrently 
with a BASIC program, bur has the drawback of being more 
difficult. 



NOTE: ALWAYS DISABLE INTERRUPTS BEFORE CHANGING THIS VH.TOK! 



5) The CHRGET ruuline is used by BA5IC to get each character/token. 
This mckes il simple to add new BASIC command; Naturally, 
eoeh new command must be executed by a user written machine 
language subroutine. A common way to use this method is tn 
specify a character (@ for example) which will occur before any cf 
the new comrnonds. The new CHRGET routine mi I search for the 
special character. If none is present, ccrtrol is passed to the nor- 
mal BASIC CHRGFT routine. If the special chnrncrer is present, the 
new command is interpreted and executed by your machine lan- 
guage program This; miniiri^s the extrrs execution t me ridded by 
the need to search for cdditioncl commands. This tezllique Is 
often called n wedge. 
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WHERE TO PUT MACHINE LANGUAGE ROUTINES 

line best place for machine language routines on the Commodore 64 
is from $CO00— $CFFF, assuming the rourrnes are srna.ler than 4,< bytet 
long. This section of memory is not disturbed by BASIC. 

If lor some reusun il's not aussible or desirable to put the machine 
language routine at $CQQ3, for instance if the routine is larger than 4K 
bytes, il I hen becomes necessary to reserve an area at the top of mem- 
ory frcn BASIC for the routine. The top of memory is normally i9FFF. 
The top of memory can be changed "hrough the KERNAL routine 
MEMTOP, or by the following BASIC statements? 

10 POKE51,L:POKE52,r1:POKE55,L:POKE56,H:CLR 

Where H and . are the high urid low uoriions, respectively, of the new 
top of memory. Fo' example, to reserve the area from $9000 to $9FFF 
for mcchine language, use the following: 

10 POKE51,0:POKE52,144:POKE55,C:POKE5o, 144tCLR 

HOW TO ENTER MACHINE LANGUAGE 

There ere 3 com-non methods to add tie machine language pro- 
grams to a BASIC program. They are: 

1 ) DATA STATEMENTS: 

By READing DATA statements, and PQKEing -he values into memory at 
the start of the program, machine langucge routines can be added. This 

is the easiest method. No specie! methods a'c needed tc save the two 
parts of the program, end it is fairly easy to debug. The drawbacks 
include taking up more memory space, and the wait while the program 
is POKEd In, Therefore, this method is better for smaller routines, 

EXAMPLE: 

1 RESTORE:FORX=T TO° : READA : POKE 1 2 s 4096 + X, A: N EXT 



BASIC PROGRAM 

1000 DATA 161,1,204,204,204,204,204,204,9a" 
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2) MACHINE LANGUAGE MONITOR (64MON): 

This program allows yau to enter □ program in ether HFX or SYM- 
BOLIC codes, and save the portion of me-nory *he program is in. Advan- 
tages of tbts method include easier entry of the machine language 
routines, debugging aids, end c much fo:s*er means of saving and load- 
ing. The drawback trj this method is that If generally requires the BASIC 
program to load the rrachine language routine from tape or disk when 
it is started. (For more details on 64MON see the machine language 
section,; 

EXAMPLE: 

The following is en example o c a BASIC program using a machine 
language routine prepared by 64MON. The routine is stored on tape; 

10 IF FLAG-1 THEN 20 

15 FLAG = liLOAD "MACHINE LANGUAGE ROUTINE NAME", 1,1 

20 



REST OF BASiC PROGRAM 
3) EDITOR/ASSEMBLER PACKAGE; 

Advantages are similar to using o machine language monitor, but 
programs are even easier *o enter. Disadvantages ere also similar to the 
use of c machine language monhcr. 



COMMODORE 64 MEMORY MAP 



LABEL 


HEX 
ADDRESS 


DECIMAL 

LOCATION 


DESCRIPTION 


D6510 


0000 





6510 On-Chip Data- 
Direction Register 


R6510 


0001 


1 


6510 On-Chip 8-Bit 
Input/Output Register 




0002 


2 


Unused 


ADRAY1 


DOM- 0004 


3-4 


Jump Vector; Convert 
Floating — Integer 
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LABEL 


HEX 
ADDRESS 


DECIMAL 
LOCATION 


DESCRIPTION 


ADRAY2 


0005-0006 


5-6 


Jump Vector: Convert 
Integer Flouting 


CHARAC 


0007 


7 


Search Character 


ENDCHR 


0008 


3 


Ffag: Scan for Quote at 
End of Siring 


TRMPOS 


0009 


9 


Screen Column From Last 
TAB 


VERCK 


000A 


10 


Flcg; = Load, 1 = Ver- 
ify 


COUNT 


000 B 


11 


Input BuFfer Pointer / Mo- 
of Subscripts 


DIMFLG 


oooc 


12 


Flag: Default Array Dl 
Mensign 


VALTYP 


OOOD 


13 


Data Typ«! $FF ss String, 
$00 — Numeric 


1NTFLG 


OO0E 


14 


Data Type: $80 = Integer, 
$00 - Floating 


GARBFL 


OOOF 


15 


Flag: DATA scan/LIST 
quaWGcirbcige Cull 


SUBFLG 


0010 


16 


Flag: Subscript Ret f User 
Function Call 


INPFLG 


001 1 


17 


Flag: $00 = INPUT, $40 
- GET, $$S = READ 


TANSGM 


0012 


18 


Flag: TAN sign \ Compari- 
scn Result 




0013 


19 


Flag: INPUT Prompt 


LINNUM 


00U-O0I5 


20-21 


Temp; Integer Value 


TEMPPT 


0016 


22 


Pointer Temporary String 
Stock 


LASTPT 


0017-0018 


23-24 


Lost Temp String Address 


TEMP5T 


0019 0021 


25-33 


Stack for Temporary 
Strings 


INDEX 


0022-0025 


34 37 


Utility Pointer Area 


RES MO 


0026- 002 A 


38-42 


Floating-Point Product of 
Multiply 


TXTTAB 


0D2B-DQ2C 


AZ-AA 


Pointer: Start of BASIC 
Text 
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LABEL 


HEX 
ADDRESS 


DECIMAL 
LOCATION 


DESCRIPTION 


VARTAB 


0C2D-O02E 


45- .16 


Pointer: Start of BASIC 

Vijl HJ b Jtf b 


ARKTAB 


CO2F-0D3O 


47-48 


Pointer: Start of BASIC 
Arrays 


STREND 


0031-0032 


49-50 


Pointer: End of BASIC Ar- 
rays (+1) 


FRETOP 


0033-0034 


51-52 


Pointer: Bottom of String 
Store gc 


FRESPC 


0035-0036 


53-54 


Utility String Pointer 


MEMSIZ 


0037 0038 


55-56 


Pointer: Highest Address 
Used by BASIC 


CLIRLIW 


0039 -003A 


57-58 


Current BASIC Line 

Number 


OLDLIN 


003B-003C 


59-60 


Previous BASIC Line 
Number 


OLDTXT 


003D-O03E 


61-62 


Pointer: BASIC Statement 
for CONT 


DATLIN 


003 F~ 004-0 


63-64 


Current DATA Line 

Number 


DATPTR 


0041-0042 


65-66 


Pointer: Current DATA 
Item Address 


INPPTR 


0043-0044 


67 -68 


Vector: INPUT Routine 


VARNAM 


0045-004* 


69-70 


Current BASIC Variable 
Name 


VARPNT 


0047-0043 


71-72 


Pointer: Current BASIC 
Vqrioblt; DcIli 


FORPNT 


0049 -00 4 A 


73-74 


Pointer- Index Variable 
for FOR/NEXT 




004B-0060 


75-96 


Tenia Pointer I Data Area 


F AC EXP 


0061 


97 


Floating-Point Accumu- 
lator #1: Exponent 


TAG HO 


0062-0065 


98-101 


Floating Ace u in. #1: 
Mantissa 


FACSGN 


0066 


102 


Floating Actum. #1: Sign 


SGNFLG 


GOG 7 


103 


Pointer: Series. Evaluation 
Constant 
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LABEL 



HEX 
ADDRESS 



DECIMAL 

LOCATION 



DESCRIPTION 



BITS 

ARGCXP 

ARGHO 

ARGSGN 
ARISGN 

FACOV 

FBUFPT 
CHRGCT 

CHRGOT 

TXTPTR 

RNDX 

STATUS 



0068 

0069 

0O6A-0C6D 

O06E 
006 F 

0070 

007? -0072 
0073 -003 A 

0079 

007A-OD7B 

0OSB-003F 
0090 



STKEY 


0091 


145 


SVXT 


0092 


U6 


VEBCK 


0093 


T47 


C3PO 


0094 


148 


BSOUR 


0095 


ld9 


SYNO 


OOPS 


150 




0097 


151 


LDTND 


0093 


152 


DFLTN 


0099 


153 


DFLTO 


009A 


154 



104 
105 
106-109 

no 
in 

112 

113-114 
115-138 

121 

122- 123 

139-143 

144 



Floating Accuin. #1 : 

Overflow Digit 
Floating-Point Accumu- 
lator #2: Exponent 
Floating A«um, #2; 

Mantissa 
Floating Accum. #2: Sign 
Sign Comparison Result; 

Accum. #1 vs #2 
Floating Atcum, #1. 

Low-Order (Rounding) 
Pointer: Cassette Buffer 
Subroutine; Get Next Byte 

of BASIC T&xt 
Ent-y to Get Some Byte of 

Text Again 
Painter: Current Byte of 

BASIC Tew 
Floating RND Function 

Seed Value 
Kernal I/O Status 

Word: ST 
Flag: STOP key / RVS key 
Timing Constant for Tape 
Flag: = Locd, 1 = Ver- 
ify 
Flag: Serial Bus — Output 

Char. Buffered 
Buffered Character for 

Serial Bus 
Cassette Sync No. 
Temp Dota Area 
No. of Open Filet / Inde* 

to File Table 
Default Input Device (0) 
Default Output (CMD) 

Device (3) 
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LABEL 


HEX 
ADDRESS 


DECIMAL 
LOCATION 


DESCRIPTION 


MtTY 


GWB 


155 


Tape Character Parity 


DPSW 


O09C 


156 


Flag: Tape Byte-Received 


MSGFLG 


009D 


157 


Flag: 580 - Direct Mode, 
$00 = Program 


PTRI 


009E 


153 


Tape Pass 1 Error Log 


PTR2 


009F 


15? 


Tape Pass 2 Error Log 


TIME 


00AC-OOA2 


1 60 162 


Real-Time Jiffy Clock 
(appro*) 1/60 Sec 




00A3-00A4 


163-164 


Temp Data Area 


CNTDN 


00A5 


165 


Cassette Sync Countdown 


BUFPNT 


00A6 


166 


Pointer: Tape I/O Buffer 


1NBIT 


00A7 


167 


RS-232 Input Bit* / Cas- 
sette Temp 


BITCI 


00A8 


163 


RS-232 Input Bit Count / 
Colette Temp 


RINONE 


00A9 


169 


RS-232 Flag: Check for 
Start Bit 


RIDATA 


OOAA 


170 


RS-232 Input Byte 
Buffer/Cassette Temp 


RIPRTY 


OOAB 


171 


RS-232 Input Parity / Cas- 
setle Short Cnt 


SAL 


0OAC-0OAD 


172-173 


Pointer; Tape Buffer/ 
5creen Scrolling 


EAL 


OOAE OOAF 


174 175 


Tape End Addresses/End 
of Program 


CMPO 


0O&0-0081 


176-177 


Tape Timing Constants 


TAPE1 


00B2-0QB3 


178-179 


Pointer: Start of Tape Buf- 
fer 


BITT5 


00B4 


180 


RS-232 Out Bit Count I 
Cassette Temp 


NXTBIT 


00 B5 


1ST 


RS-232 Next Bit to Send/ 
Tape EOT Flag 


RODATA 


00B6 


182 


RS-232 Out Byte Buffer 


FSILEN 


0OB7 


183 


Length of Current File 
Name 


LA 


OUBS 


184 


Current Logical File 
Number 
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LABEL 


HEX 
ADDRESS 


DECIMAL 
LOCATION 


DESCRIPTION 


SA 


0DB9 


185 


Current Secondary Ad- 
dress 


FA 


OOBA 


186 


Current Device Number 


FNADR 


OOBB ODBC 


187 IB8 


Pointer; Current File 
Name 


ROPRTY 


00 BD 


189 


RS-232 Out Parity / Cas- 
sette Temp 


FSBLK 


008E 


190 


Cassette Read/Write Bloek 
Count 


MYCH 


OOBF 


191 


Serial Word Buffer 


CAS1 


OOCO 


1?2 


Tape Motor Interlock 


STAL 


00C1-00C2 


193-194 


I/O Start Address 


MEMLP5S 


00C3-00C4 


1?5-1?6 


Tape Load Temps 


LSTX 


00C5 


197 


Current Key Pressed; 
CHR$(n) - No Key 


NDX 


OQC6 


198 


No. of Chars, in 
Keyboard Buffer 
(Queue) 


RVS 


Q0C7 


199 


Flag: Print Reverse 

Chars. 1 =Yes, = No 

Used 


INDX 


00C8 


200 


Pointer; End of Logical 
Line for INPUT 


LXSP 


O0C9-0OCA 


201-202 


Cursor X-Y PoS. nt Start of 
INPUT 


SFDX 


0OCB 


203 


Flag: Print Shifted Chars. 


BLNSW 


OOCC 


204 


Cursor Blink enable; = 
Flash Cursor 


BLNCT 


OOCD 


205 


Timer; Countdown 1o 
Toggle Cursor 


GDBLN 


OOCE 


206 


Character Under Cursor 


BLNON 


00CF 


207 


Flag: lost Cursor Blink 
On/Off 


CRSYV 


O0DO 


206 


Flag: INPUT or GET from 
Keyboard 


PUT 


OOD1-COD2 


209-210 


Pointer: Current Screen 
Lint Address 
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LABEL 


HEX 
ADDRESS 


DECIMAL 
LOCATION 


DESCRIPTION 


PNTR 


00D3 


211 


Cursgr Column on Current 
Line 


QTSW 


00D4 


212 


Flag: Editor in Quote 
Mode, $00 = NO 


LNMX 


Q0D5 


213 


Physical Screen Line 
Length 


TBLX 


00D6 


2)4 


Current Cursor Physical 
Line Number 




00D7 


275 


Temp Data Area 


INSRT 


00D8 


216 


Flag: Insert Mode, >0 — 
# INSTs 


L0TB1 


QOD9-00F2 


217-242 


Screen Line Link Table / 
Editor Temps 


USER 


0OF3-O0F4 


243-244 


Pointer; Current Screen 
Color RAM loc. 


KEYTAB 


0OF5-O0F6 


245-246 


Vectcii: Keyboard Decode 
Table 


RIBUF 


0OF7 O0F8 


247-243 


RS-232 Input Buffer 
Pointer 


ROBUF 


00F9-00FA 


249- 250 


RS-232 Output Buffer 
Pointer 


FREKZP 


0OFB-00FE 


251 254 


Free 0-Page Space for 
User Programs 


BASZPT 


OOFF 


255 


BASIC Temp Data Area 




0100-01 FF 


256-511 


Micro-Processor System 
Stack Area 




01 00- 01 OA 


256-266 


Floating to String Work 
Area 


BAD 


0100 01 3E 


256-313 


Tape Input Error Locj 


BUF 


0200-0258 


512-600 


System INPUT Buffer 


LAT 


025? 0262 


601-610 


KERNAL Table: Active Log- 
ical File No's. 


FAT 


0263- 02 6C 


611 620 


KERNAL Table: Device No. 
" for Eoch File 


SAT 


026D-0276 


621-630 


<ERNAL Table: Second 
Address Each File 


KEYD 


0277-0280 


631-640 


Keyboard Buffet Queue 
(FIFO) 
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LABEL 


1 

HEX 
ADDRESS 


DECIMAL 
LOCATION 


DESCRIPTION 


MEMSTfi 


0281-0282 


641-642 


Pointer: Bottom of Memory 
forO.S. 


MEMSIZ 


028.1-0284 


643-644 


Pointer: Top of Memory ror 
O.S. 


TIMOUT 


0285 


645 


Flog: Kemtnl Variable for 
IEEE Timeout 


COLOR 


0286 


646 


Current Character Color 
Code 


GDCOL 


0287 


647 


Background Color Under 
Cursor 


HIBASE 


0288 


648 


Top of Screen Memory 
<Page) 


XMAX 


0289 


649 


Size of Keyboard Buffer 


RPTFLG 


028A 


650 


Flag; REPEAT Key Used, 
S80 = Repeat 


KOUNT 


0286 


65] 


Repeat Speed Counter 


DELAY 


C2SC 


652 


Repeat- Delay Counter 


SHFIAG 


028D 


653 


Flag, Ke/b'rd SHIFT Key/ 
CTRL Key/C- Key 


LSTSHF 


028E 


654 


Last Keyboard Shift Pat- 
tern 


KEYLOG 


028F-0290 


655-656 


Vector: Keyboard Table 
Setup 


MODE 


0291 


657 


Hag; SO0 = Discible SHIFT 
Keys, $30 = Enable 
SHIFT Keys 


AUTODN 


0292 


658 


Flag: Auto Scroll Down, 
= DN 


M51CTR 


0293 


659 


RS-232: 6551 Control 
Register Image 


M5TCDR 


0294 


660 


RS-232; 6551 Command 
Regis'er Image 


M51AJB 


02P5 0296 


66 1 662 


RS-232 Non Standard EPS 
(Time/2-1 00) USA 


RSSTAT 


0297 


663 


RS-232: 6551 Status Regit- 

ter Image 


EITNUM 


02?3 


664 


RS-232 Number of Bits 
Left to Send 
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LABEL 


HEX 
ADDRESS 


DECIMAL 
LOCATION 


DESCRIPTION 


6AUDOF 


0299- D29A 


665-666 


RS-232 Baud Rate: Fufl Bft 
Time (,l:s) 


RIDBE 


029B 


667 


RS-232 Index to End of 
input Buffer 


RIDBS 


029C 


663 


RS-232 Start of Input Buf- 
fer (Page) 


RODB5 


029D 


66? 


RS-232 Start of Output 
Buffer [Page) 


RODBE 


029E 


670 


RS-232 Index to End of 
Output Buffer 


IRQTMP 


029F-O2A0 


671-672 


Hold; IRQ Vector During 
Tape I/O 


ENABL 


02AI 


673 


RS-232 Enables 




02A2 


674 


TOD Sense During Cas- 
sette I/O 




C2A3 


675 


Temp Storage For Cassette 
Read 




02A4 


676 


Temp D1IRQ Indicator Far 

Cassette Bend 




C2A5 


677 


Temp For Line Index 




C2A6 


678 


PAUNTSC Flag, = 
NTSC, 1= PAL 




02A7-02FF 


679-767 


Unused 


IERROR 


0300- 0301 


763-769 


Veciar: Print BASIC Error 
Message 


IMAIN 


0302-0303 


770-771 


Vector: BASIC Warm Start 


ICRNCH 


0304-0305 


772 -773 


Vector: Tckenize BASIC 
Text 


IQPLOP 


0306-0307 


774- 775 


Vector: BASIC Text LIST 


IGONE 


030S 0309 


776-777 


Vector: BASIC Char. Dis- 
patch 


IEVAL 


030A 030B 


77B-77P 


Vector: BASIC Token 
Evaluation 


SAREG 


030C 


780 


Storage for 6502 A Reg- 
ister 


SXEEG 


030D 


781 


Storage for 6502 .X Regis- 
ter 
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LABEL 



+ 



HEX 
ADDRES5 



SYREG 
SPKEG 

USRPOK 
USRADD 

CINV 

CBINV 
NMINV 

IOPEN 

TCLOSE 

ICHKIN 

ICKOUT 

ICLRCH 

I BASIN 

IBSOUT 

ISTOP 

IGETIN 

ICLaLL 

USRCMD 
ILOAD 



030E 

030F 

03)0 

0311-031? 

0313 
0314-0315 

0316-0317 
0318-0319 

031A-031B 

03TC-031D 

O31E-031F 

0320-0321 

0322-0323 

0324-0325 

0326-0327 

0323-0329 

03 2 A- 03 2 B 

032C-032D 

032E-032F 
0330-0331 



DECIMAL 
LOCATION 



DESCRIPTION 



7B2 Storage for 6502 .Y Regis- 

ter 

733 Storcge far 6502 ..SP 

Register 

734 (JSfi Function Jump Insir 

(4C) 
785-786 USR Address low Byte/ 

High Byte 
787 Unused 

788-789 Vector; Hardware IRQ 

Interrupt 
790-791 Vector: BRK Instr. Interrupl 

792-793 Vector; Non-Moskuble 

Interrupt 
794 795 KERNAL OPEN Routine 

Vector 
796-797 KERNAL CLOSE Routine 

Vector 
798-799 KERNAL CHKIN Routine 

Vector 
800-801 KERNAl CHKOUT Routine 

Vector 
802-303 KERNAl CIRCHN Routine 

Vector 
804-305 KERNAL CHRIN Routine 

Vector 
806-307 KERNAL CHROUT Routine 

Vector 
808-809 KERNAL STOP Routine 

Vector 
810-8)1 KERNAL GETIN Routine 

Vector 
812-813 KERNAL CLALL Routine 

Vectn r 
814-815 User-Defined Vfector 

816-817 KERNAL LOAD Routine 

Vector 
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LABEL 


HEX 
ADDRESS 


DECIMAL 
LOCATION 


DESCRIPTION 


ISAVE 


0332-0333 


818-819 


KfRNAL SAVE Routine Vec- 
tor 




D334-033B 


820-827 


Unused 


TBUFFR 


033C-03FB 


S28 101 9 


Tope I/O Buffer 




03FC-03FF 


1020-1023 


Unused 


ViCSCN 


0400- 07FF 


1024 2047 


1024 Byte Sceen Memory 

Area 




0400- 07E7 


1024-2023 


Video Matrix; 25 Lines X 
40 Columns 




07FS-07FF 


2040-2047 


Sprits Data Pointers 




0800- 9FFF 


2048-40959 


Normal BASIC Program 
Spat;* 




S0O0-9FFF 


32768-40959 


VSP Cartridge ROM— 
8192 Byres 




A00O-&FFF 


40960-49151 


BASIC ROM— SI 92 Bytes 

(nrSlC RAM) 




C00O-CFFF 


49152-53247 


RAM — 4096 Bytet 




DOOO-DFFF 


53248-57343 


Input'Output Devices and 

Color RAM 
or Character Generator 

ROM 
of RAM— 4096 Bytes 




EOOO FFFF 


57344-65535 


K.ERNAL ROM — Si 92 
Bytes (or 8K RAM'i 



COMMODORE 64 INPUT/OUTPUT ASSIGNMENTS 



HEX 


DECIMAL 


BITS 


DESCRIPTION 


0000 





7-0 


MQS ^510 Data Direction 

Register (xx 101 111) 
Bit=l = Output, Bir=0: 
Input. x = Don't Care 


0001 


1 




MOS 6510 Micro-Processor 
On-Chip I/O Port 









/LORAM Signal (0-Switch 
BASIC ROM Out> 
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HEX 



D0O0-D02E 



D011 



DECIMAL 



53246-54271 



DOOO 


53248 


DOOl 


■53249 


D0O2 


53250 


D003 


53251 


D004 


53252 


DO05 


53253 


DO06 


53254 


D0O7 


53255 


DOOS 


53256 


D0O9 


53257 


DMA 


53258 


DOOB 


53259 


DOOC 


53260 


DOOD 


53261 


DOOE 


53262 


DOOF 


53263 


D01D 


53264 



BITS 



5 
6-7 



53265 



DESCRIPTION 



/HIRAM Signal (0=Switch 

Kernal ROM Out) 
/CHAR EN Signal 

(0=SwItch Char, ROM 
In) 

Cassette Data Output Line 

Cassette Switch Sense 
= Switch Closed 

Cassette Motor Control 

= ON, 3 = OFF 

Undefined 

MOS 6566 VIDEO INTER- 
FACE CONTROLLER 
(VIC) 

Sprite X Pos 

Sprite Y Pos 

Sprite 1 X Pos 

Sprite T V Pos 

Sprite 2 X Pos 

Sprite 2 Y Pos 

Sprite 3 X Pos 

Sprite 3 Y Pos 

Sprite 4 X Pos 

Sprite 4 Y Pos 

Sprite 5 X Pos 

Sprite 5 Y Pos 

Sprite 6 X Pos 

Sprite 6 Y Pos 

Sprite 7 X Pos 

Sprite 7 Y Pos 

Sprites 0-7 X Pos (msb of 
X coord.) 

VIC Control Register 

Raster Compare: (Bit S) 
See 53266 

Extended Color Text 
Mode: 1 — Enable 



BASIC TO MACHINE LANGUAGE 



321 











HEX 


DECIMAL 


BITS 


DESCRIPTION 






5 


Bit-Mop Mode: 1 =- En- 
able 






4 


Blank Screen to Border 
Color: = Blank 






3 


Select 24/25 Row Text 
Display: 1 = IS Rows 






2-0 


Smact-t Scroll to Y Dot- 
Position (0-7J 


D012 


53266 




Read Rusier 1 WHe Raster 
Value for Compere IRQ 


D013 


53267 




Light-Pen Ltitch X Pa* 


D014 


53268 




Light-Pen Latch Y Pos 


D015 


53269 




Sprite Display Enable: 
1 = Enable 


D016 


53270 




VIC Control Register 






7-6 


Unused 






5 


ALWAYS SET THIS BIT TO 
0! 






A 


Multi Color Mode: 1 ~ 
Enable (Text or Bit- 
Ma p) 






3 


Select 33/40 Column Text 
Display: 1 = 40 Cok 






2-0 


Smooth Scroll to X Pos 


D017 


53271 




Sprites 0-7 Expand 2X 

Vertical (Y) 


D018 


53272 




VIC Memory Control Reg- 
5ter 






7-4 


Video Matrix Bait? Ad- 
dress [inside VIC) 






3-1 


Character Dot- Data Base 
Address (inside VIC) 


D019 


53273 




VIC Interrupt Flag Regis- 
ter (Bit = 1: IRQ Oc- 
curred) 






7 


Set on Any Enabled VIC 
IRQ Condition 






3 


Light-Pen Triggered IRQ 
Fit; si 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 






2 


Sprite to Sprite Collision 
IRQ Flog 






1 


Sprite to Background 




i 


Collision IRQ Flag 







Raster Compare IRQ Flag 


D01A 


53274 




IRQ Mask Register; 1 = 
Interrupt Enabled 


D01B 


53275 




Sprite to Background 
Display Priority: 1 = 

Sprite 


DOIC 


53276 




Sprites 0-7 Multi-Cole 
Mode Select: 1 — 
M.C.M. 


DC1D 


53277 




Sprites 0-7 Expand 2X 
Horizontal (X) 


D01E 


53278 




Sprite 1o Sprite Collision 
Detect 


DOIF 


5327? 




Sprite to Background 
Collision Detect 


D020 


53280 




Border Color 


D021 


53281 




Background Color 


D022 


53282 




Background Color 1 


D023 


53283 




Background Color 2 


D024 


53284 




Background Color 3 


D025 


53285 




Sprite Multi-Color Regis- 
ter 


D026 


33286 




Sprite Multi-Color Regis- 
ter 1 


D027 


53287 




Sprite Color 


D028 


53238 




Sprite 1 Color 


D029 


53289 




Sprite 2 Color 


DO? A 


53290 




Sprite 3 Color 


D02B 


53291 




Sprite 4 Color 


D02C 


53292 




Sprite 5 Color 


D02D 


53293 




Sprite 6 Colcr 


DQ2E 


53294 




Sprite 7 Color 


D40Q-D7FF 


54272-5525*5 




MOS 6581 SOUND 
INTERFACE DEVICE 
(SID) 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 


D400 


54272 




Voice I: Frequency 
Control — Low- Byte 


D401 


54273 




Voice 1; Frequency 
Control — High-Byte 


D402 


54274 




Voice 1: Pulse Waveform 
Width — Low-Byte 


D403 


54275 


7-4 


U n used 






3-0 


Voice 1: Pulse Waveform 
Width — High-Nyhble 


D404 


54276 




Voice 1: Control Register 






7 


Select Random Noise 
Waveform, 1 — On 






o 


Select Pulse Waveform, 
T = On 






5 


Select Sawtooth 

Waveform, 1 = On 






4 


Select Triangle Waveform, 
1 = On 






3 


Test Bit; 1 «■ Disable Os- 
rillatcr 1 






2 


Rinu Modulate Osc. 1 with 
Osc. 3 Output, 1 = On 






1 


Synchronize Osc. 1 with 
Osc. 3 Frequency, 1 = 
On 






C 


Gate Bit: 1 = Start Art/ 
De«/Sus, = Start Re- 
lease 


D4C = 


54277 




Envelope Generator 1; At- 
tack / Decay Cycle 
Control 






7-4 


Select Attack Cycle Dura- 
tions 0-15 






3-0 


Select Decay Cycle Dura- 
tion: 15 


D4Q6 


54273 




Envelope Generator 1; 
Sustain / Release Cycle 
Control 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 






7-4 


5elect Sustain Cyels Du- 
ration; 0- 15 






3-0 


Select Release Cycle Du- 
ration; 0-15 


D407 


54279 




Voice 2: Frequency 
Control — Low-Byte 


D4D8 


54280 




Voice 1: Frequency 
Control — High-Byte 


D409 


54281 




Voire 1'. Pulse Wfivetorm 
Width — Low-Byte 


D4QA 


54282 


7-4 


Unused 






3-0 


Voice 2: Pulse Waveform 
Width — High-Nybble 


D40B 


54283 




Msice 2; Control Register 






7 


Select Random Noise 
Waveform, 1 — On 






6 


Select Pulse Waveform, 

1 = On 






5 


Select Sawtooth 

Waveform, 1 = On 






4 


Select Triangle 

Waveform, '1 = Dn 






3 


Te>1 Git: 1 = Double Oi- 
cillator 2 






2 


Ring Modulate Oic. 2 with 
Ose. 1 Output, I = On 






1 


Synchronise Osc. 2 with 
Ose. 1 Frequency, I = 
On 









Gate Bit: 1 ~ Start Att/ 
Dec/Sus, = Start Re- 
lease 


D40C 


54284 




Envelope Generator 2: At- 
tack / Decay Cycle 
Control 






7-4 


Select Attack Cycle Dura- 
tion: 0-15 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 






3-0 


Select Decay Cycle Dura- 
tion: 0-15 


D40D 


54285 




Fnvelope Generator 2: 
Sustain / Re lease Cycle 
Control 






7-4 


Select Sustain Cycle Du- 
ration; 0-15 






3 


Select Release Cycle Du- 
ration: — 15 


D40E 


542B6 




Voice 3: Frequency 
Control — Low- Byte 


D40F 


54287 




Voice 3: Frequency 
Control — High-Byte 


D410 


54288 




Voice 3: Pulse Waveform 
Width — Low- Byte 


0411 


54289 


7-4 


Unused 






3-0 


Voice 3: Pulse Waveform 
Widih — High-Nybble 


D412 


54290 




Voice 3: Control Register 






7 


Select Random Noise 
Waveform, 1 = On 






6 


Select Pulse Waveform, 1 

= On 






5 


Select Sawtooth 

Waveforrrij 1 = On 






4 


Select Tiiunijle Waveform, 
1 = On 






- 


Test Bit: 1 = Dboble Os- 

cillnror 3 






1 


Ring Modulate Osc. 3 with 
Osc. 2 Output, 1 = On 






1 


SyncTronize Osc- 3 with 

Osc. 2 Frequency, 1 — 
On 






0' 


Gate Bit: 1 = Start At!/ 
Dec/Sus, - Start Re- 
lease 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 


0413 


54291 




Envelope Generator 3: At- 
tack / Decay Cycle 
Control 






7-4 


Select Attack Cycle Dura- 
tion: 0-T5 






3-0 


Select Decay Cycl* Dura- 
tion: 0-15 


D414 


54292 




envelope Generator 'A: 
Sustain / Release Cycle 
Control 






7-4 


Select Sustain Cycle Du- 
ration: 0—15 






3-0 


Select Release Cycle Du- 
ration: — 15 


D415 


54293 




Filter Cutoff Frequency: 
Low-Nybble (Bits 2-0) 


D4I6 


54294 




Filter Cutoff Frequency: 
High,- Byte 


D417 


54295 




filter Resonance Control / 
Voice Input Control 






7-4 


Select Filter Resonance: 
0-15 






3 


Filter External Inputs 1 = 
Yes, - No 






2 


Filter Voice 3 Output: 1 = 
Yes, = No 






1 


Filter Voice 2 Output: 1 = 
Yes, = No 









Filter Voice 1 Output: 1 = 
Yes, = No 


D418 


54296 




Select Filter Mode and 
Volume 






7 


Cut-Off Voire 3 Output: 1 
- Off, - On 






6 


Select Filter High-Pass 
Mode: 1 = On 






5 


Select Filter Band-Pass 
Mode: 1 = On 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 






4 


Select Filter Low-Pass 
Mode; 1 - On 






3-0 


Select Output Volume: 
0-15 


D419 


54297 




Arinlog/Digijol Converter: 
Game Paddle 1 (0- 
255} 


D41A 


5429B 




Analog/Digital Converter: 
Game Paddle 2 (0- 
255) 


D418 


54299 




Oscillator 3 Random 
Number Generator 


D41C 


54230 




Envelope Generator 3 
Output 


D5C0-D7FF 


5452B-55295 




SID IMAGES 


DaOO-DBFF 


5529&-56319 




Cclor RAM (Mybblesj 


DCOO-DCFF 


56320-56575 




MOS 6526 Complex 

Interface Adopter (CIA) 
#1 


DC 00 


56320 




Data Port A {Keyboard, 
Javali(.k, Paddles, 
Light-Pen) 






7-0 


Write Keyword Column 
Nfahie'i far Keyboard 
Scan 






7-6 


Read Paddles on Port A / 
B (01 - Port A, 10 = 
Port B) 






4 


Joystick A Fire Button: 1 — 
Fire 






3-2 


Paddle Fire Butters 






3-0 


Joystick A Direction 
(0-15) 


DCOl 


56321 




Data Port B (Keyboard, 
Joystick, Paddles): 








Gone Port 1 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 






7 


Read Keyboard Row 
Values for Keyboard 
Scon 






7 


Timer B: Toggle/Pulse 
Output 






6 


Timer A: Toggle/Pulse 
Output 






4 


Joystick 1 Fire Button: 1 = 






Fire 






3-2 Paddle Fire Buttons 






3 Joystick 1 Direction 


DC02 


56322 




Date Direction 
Register Port A 
(56320) 


DC03 


56323 


■ 


Dcita Dire-clion 
Register — Port B 
(56321) 


DC04 


56324 




Tinier A: low-Byte 


DC05 


56325 




Timer A; High-Byte 


DC06 


56326 




Timer B: Low-Byte 


DC07 


56327 




Timer 1A: High-Byte 


DC08 


56328 




Time-of-Day Clock: 1/10 
Seconds 


DCOP 


56329 




Time-of-Day Clock: Sec- 
onds 


DCOA 


56330 




Time-of-Day Clock: Min- 
utes 


DCQB 


56331 




Time-of-Day Clock: Hours 
+ AM/PM Flag (Bit 71 


DCOC 


56332 




Synchronous Serial I/O 

Data Buffer 


DCOD 


56333 




CIA Interrupt Control 
Register (Read IRQs/ 
Write Mask) 






7 


IRQ Flog (1 = IRQ Oc- 
curred) 1 Set-Clear Flag 






4 


FLAG! IRQ (Cassette Read 
/ Serial Bus SRQ Input) 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 






3 


Serial Port Interrupt 






2 


Time-oF-Day Clock Afarm 
Interrupt 






T 


Timer B Interrupt 









Timer A Interrupt 


DCOE 


56334 




CIA Control Regis'er A 






7 


lime-af-Day Clock Fre- 
quency; 1 = 50 Hi, 
= 60 Mi 






6 


Serial Port I/O Mode; 1 - 
Output, = Input 






5 


Timer A Cojnts: 1 — CNT 

Signals, = System 02 
Clock 






4 


Force Load Timer A; 1 — 
Yes 






3 


Timer A Run Mode: 1 = 
One-Shot, = Con- 
tinuous 






2 


Timer A OutpLT Mode T3 
PB6: 1 = Toggle, = 
Pulse 






1 


Timer A Output en PB6: 1 

= Yes, = No 









Start/5rop Timer A: 1 = 
Slart, = Stop 


DCOF 


56335 




CIA Control Register B 






7 


Set Alarm/TOD-Clock: 1 =- 
Alorm, = Clock 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 






6-5 


Timer B Mode Select: 

00 = Count System D2 
Clock Pulses 

01 = Count Positive 
CNT Transitions 

10 = Count Timer A 
Underflow Pulses 

11 = Count Tirrer A 
Underflows While 
CNT Poiitive 






4-0 


Same as CIA Control Reg. 
A— for Timsr B 


DDOO-DDFF 


56576-56331 




MOS 6526 Complex Inter- 
face Adapter (CIA) #2 


DDOO 


56576 




Daia Por< A (Seriul Bus, 
RS-232, VIC Memory 
Control) 






7 


Serial Bus Data Input 






6 


Serial Bus Clock Pulse 
Input 






5 


Serial Bus Data Output 






4 


Serial Bus Clock Pulse 
Output 






3 


Serial Bus ATN Signal 
Output 






2 


RS-232 Data Output (User 
Port} 






1-0 


VIC Chfp System Memory 
Bonk Select (Default = 
11) 


DDOl 


56577 




Data Port B (User Port, 

RS-232) 






7 


User / RS-232 Data Set 
Ready 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 






6 


User / RS-232 Clear ho 
Send 






5 


User 






4 


User / RS-232 Carrier De- 
tect 






3 


User / RS-232 Ring Indi- 
cator 






2 
1 


User / RS-232 Data Termi- 
nal Ready 

User / RS-232 Request ro 
Send 









User / RS-232 Received 
Dara 


DD02 


54578 




Data Direction 
Regis-rer — Port A 


DDQ3 


56579 




Data Direction 
Register — Fori B 


DD04 


56580 




Timer A: Low-Byte 


DD05 


56581 




Timer A: High-Byte 


DD06 


56582 




Timer B: Low-Byte 


DD07 


56583 




Timer B: High-Byte 


DD08 


56584 




Time-o-f-Doy Clock: 1/10 
Seconds 


DD09 


56585 




Tim^-o-f-Doy Clock: Sec- 
onds 


DDOA 


56586 




Time-rrf-Dny Clock: Min- 
utes 


DDOB 


56587 




Time-of-Day Clock; Hours 
+ AM/PM Fliag (Bit 7) 


DDOC 


36588 




Synchronous Serial I/O 
Data Buffer 


DDOD 


5658? 




CIA Interrupt Control 
Register (Read NMk: 
Write Modi) 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 






7 


NAM Flag (1 - NMI Oc- 
curred) / 5et-Cleor Flag 






4 


FLAG1 NMI [User/RS-232 
Received Delta Input) 






3 


Serial Port Interrupt 






1 


Timer B Interrupt 









Timer A Interrupt 


DDOE 


56590 


CIA Control Register A 






7 


Time-of-Day Cluck Fre- 
quency: 1 = 50 H7, 
= 60 Hz 






6 


Serial Port I/O Mode: 1 = 
Output, — Input 






5 


Timer A Counts: 1 = CNT 
Signals, = System 02 
Cloclc 






4 


Force Lood Tinner A; 1 = 
Yes 






3 


Timer A Run Mode: 1 = 
One-Shot, — Con- 
tinuous 






2 


Timer A Output Mode to 
PB6: 1 = Toggle, = 
PuUe 






1 


Timer A Output on P86: T 
= Yes, = No 









Start/Step Timer A: 1 = 
Start, = Slop 


DDOP 


56591 




CIA Control Rfniitpr B 






7 


SetAloWTOD-Clock: 1 = 
Alarm, = Cloclc 
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HEX 


DECIMAL 


BITS 


DESCRIPTION 








6-5 


Timer B Mode Select; 




. 


■ 






00 = Count Syslem 02 




■ 








C ock Pulses 










01 — Count Positive 












CNT Traniiticns 












10 — Count Timer A 




. 








Underflow Pulses 
1 1 = Count Timer A 












Underflows While 












CNT Positive 


■ 








4-0 


Same ;is CIA Control Reg. 




' 








A for Timer B 






DEOO-DEFF 


56832-57087 




Reserved for Future I/O 












Expansion 




DFO0-DFFF 


57088-57343 




Reserved for Future I/O 












Expansion 






- 









• 









- 



" 
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CHAPTER 



INPUT/OUTPUT 
GUIDE 

1 Introduction 

• Output to the TV | 
-• Output to Other Devices 

• The Game Ports 

• RS-232 Interface Description 

• The User Port 

• The Serial Bus 

• The Expansion Port 

• Z-80 Microprocessor Cartridge 



INTRODUCTION 

Computers have three bojic abilities: 'hey can calculate, make deci- 
sions, and communicate. CalcUation is prnhnb y the easiest to program. 
Most of the rules of mathematics are familiar to us. Decision making is 
rot too difficult, since tie rules of log'c ars relatively few, evert if you 
don't krow them too well yet. 

Communication is the most complex, because it invnlvRs the least 
exactirg Est of rules. This is not on oversight in the design of computers. 
The rules allow enough flexbility to communicate virtually anything, and 
in many possible ways. The enly real ride is this; whatever sends infor- 
mation must present the information so *hat it can be understood by the 

receiver. 



OUTPUT TO THE TV 

The slmpest form of output in BASIC Is the PRINT statement. PRIN' 
u&cs the TV sceen at the output device, and your eyes arc the input 
device because they use the information on the screen. 

When PRINTirg on the screen, your main objective is tc format the 
reformation on the scree'i so it's bus/ to reud. You should try to think like 
a graphic artist, using colon, placement cf 'etters, capital and lower 
case letters, as well as graphics to oest conimunicLjIe the information, 
Remember, no matter how imort your program, you want to be able to 
understand what the results mean to you. 

I he PklNT statement uses certain character codes as 'commands" to 
■he trurso'. The ^233 key doesn't actually display anything!, it just 
makes The cursor change position. Orhe' commands chenge colors, 
clear the screen, anc insert or delete spaces. The d2J]]]2| key has a 
character code numher (CJ-R$) af 1 3. A complete table of these codes is 
contained in Appendix C. 

There are two functions in the BAS.C language that work wirh the 
PRINT statement. TAB positions the cursor on the given posit on from the 
left edge of the screen, SPC moves the cursor right a given number o" 
spaces from the current position. 

Punctuation marks in the PRINT s-atement serve to separa-e end for- 
mat information. The semicolon (;) aeoarates 2 items without any space3 
in between, f it is ihe last thing on a line, the cursor remains after the 
lost thing PRINTed instead of gong down tc the next line, it suppresses 
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(replaces) the RETURN character -hnt s nnrrrally PRIiMTsri nt the end of 
the line. 

The comma (,) separates items into columns. The Commodore 64 has 
4 columns of 10 characters each on f he screen. When the computer 
PRINTs a comma, it moves tie cursor right to the staa of the next col- 
umn. If it is post the In ft column of the line, ft moves the cursor down to 
the rext line. Like the semicolon, If it is the last item on a line *he 
RE~U3N is suppressed. 

The quote marks (" ") separate literal text from variables. Thp first 
quote mark on the line starts the literal area, and the next quote mark 
ends it. By 'he way, you don't have ta have a final quote mark at the 
end of the lino. 

The RETURN! code (CHR$ code of 13) makes the curso' go To The next 
logica* Ire an the screen. This is not always the very next line. When 
you type past the end o* a line, that line is linked to the nexT ine. The 
computer knows That both lines are really one long line. The inks are 
held in the fine link table (see the memory map for how this is set up). 

A logical line can he 1 or 2 screen lines long, depending or whal was 
typee or PRIMTed. The logical line the cursor is un delerrnines where 
th» j key sands : t. The logical line ot the top o+ the screen 

determines if the screen scrolls 1 or 2 lines at o time. 

There ore other ways to use the TV os nn outpul device. The chapter 
on graphics describes the commands to create cojects thct move across 
the screen The VIC chip section tells how the screen and harde - colo's 
and sizes are changed. And the sound chapter tells how the TV speaker 
creaTes music and special effects. 

OUTPUT TO OTHER DEVICES 

It Is often necessary to send outpjt to devices other than the screen, 
like a cassette deck, p'inter, disk drive, or modem. The CPEN statement 
in BASIC creates a "channe' to talk ta one of these devices. Once the 
channel is OPEN, the PRINTS statement will send characters to "hat 
device. 

EXAMPLE *f OPEN and PRINT* Statements: 

100 OPEN 4, 4: PRINT# 4, "WRITING ON PRINTER" 
110 OPEN 3, B, 3, "0:DI5K-FIL£,5,W": PRINT* 3, "SEND TO DISK" 
120 OPEN 1, 1, 1, "TAPE-FILE": PRINT* 1, "WRITE ON TAPE" 
130 OPEN 1, 2, 0, CHRS(IO): PRINT* 2, "SEND TO MODEM" 
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Th& OPEN Staternert is sompwhnt different for each device. The 3a- 
ranrteters in the OPEN statement are shown in the table below for each 
device. 

TABLE of OPEN Statement Parameters: 

FORMAT: OPEN flle#, device*, number, string 



DEVICE 


DEVICE# 


NUMBER 


STRING 


CASSETTE 


I 


~ Input 

1 = Output 

2 = Output with 

EOT 


File Nome 


MODEM 


2 





Control Registers 


SCREEN 


3 


0,1 




PRINTER 


4 or 5 


= Up per/ Graphics 
7 = Upper/ Lower Cose 


Text Is PRINTed 


DISK 


s to n 


2-14 = Data Channef 


Drive #, Fie Name, 
File Type, Read/Write 






15 = Command 


Corniiiund 






Cnnnnel 





OUTPUT TO PRINTER 

The printer is on output device similar to the screen. Your main con- 
cern when sending output to the printer is to rreote a forma* that is easy 
on the eyes, Your tools here ins cde reversed, double-width, capitcl and 
lav/er ccsr letters, as well as drsr-prngrnn-nrinhle graphics. 

The SPC function vvcr/cs for the printer in the seme wcy it works for the 
screen. However, the WB function does not work correctly on the print- 
er, because it calculates the current position on the 'Irte oased on the 
cursor's position on the screen, not on the paper. 

The OPEN statement tor the printer creates the chanrjei for communi- 
cation, It also specifies which character set w'll be used, either upper 
case wth graphics or upper and lewe' case. 

EXAMPLES of OPEN Statement for Printer: 

OPEN 1, 4: REM UPPER CASE/GRAPHICS 
OPEN 1,4, 7. REM UPPER AND LOWER CASE 
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When working with one character set, individual lines can be PRINTec 
in the opposite chcracter set. When in upper cose with graphics, the 
cursor down character (CHR$(T7)j switches the characters to rhe upper 
and lower case eet. When in upper and ower case, ihe cursor up char- 
acter (CHR$(145)1 allows upper case end g'apiics characters ta be 
PRIN"ed. 

Other sptxjiul furicliurii in lilt; pointer ure controlled throuch character 
codes. All these codes are simply PRINTed just like any other character. 

TABLE of Printer Control Character Codes: 



CHR$ CODE 


PURPOSE 


10 


Line feed 


13 


RETURN (automatic line feed on CBM printers) 


14 


Begin dcuble-width character mode 


15 


End double-width character mode 


13 


Begin reverse character mode 


146 


End reverse character mods 


17 


Switch to upper/lower case character set 


145 


Switch to upper case/graphics character tot 


16 


Tab to position in next 2 characters 


27 


Wove to specified dot position 


8 


Begin dot-programmable graphic mode 


26 


Repeal graphics data 



See your Commodore printer's manua for detai s on using the com- 
mand codes. 

OUTPUT TO MODEM 

The rnoderr is a simp e device that ccn translate charcete' cooes into 
audio pulses sne vice versa., so tha: computers can ;ommunica-e over 
telephone lines. The OPEN sratemen" for the modem se's up the pa- 
rameters to rratch -he speec and formct ot the other computer vol are 
cummunicalincj with. Two cha-aders can be sent in tie string at the end 
of the OPEN statement. 

The bit uos'tions of the nrst character code determire the bcud rate, 
rtumoer of dcta bits, and number of stop bits. The second code is op- 
tional, end its b ts specify rhe parity arid duplex of the trunsm ssion. See 
the RS-232 section or you- VICMDDEM manual for specific details ori this 
device. 
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EXAMPLE of OPEN Statement for Modem: 

OPEN 1, 1, 0, CHR$(6): REM 300 BAUD 

100 OPEN 2, 2, 0, CHR$(163) CHR${T12): REM 110 BAUD, FTC 

Most computers use the American Stardard Code for Inform crh'on In- 
lerchunye, known as ASCII (pronounced ASK-KEY). This standard set of 
character codes is somewhat different from the codes used in the Com- 
modore 64. When communicating with older computers, ihe Commo- 
dore character codec must be translated into their ASCII counterparts. A 
table of standard ASCII codes is included in this book in Appendix C. 

Output to the modem is ci fairly uncomplicated teslc, aside from the 
need for character translation. However , you must know trie receiving 
device fairly well, especially when wrtina programs where your 
coTiputer "talks" la another computer without human intervention. An 
example of this would be a terminal program that automatically types in 
yojr account number and secret password. To do this successfully, you 
must rnrefully count the numher nf rhnrartsrs end RFTURN chnrncters. 
Otherwise, the computer receiving the characters won't know what to do 
with them. 

WORKING WITH CASSETTE TAPE 

Cassette topes have an almost unlimited capacity Tor daiu. The 
'cnger the tape, the mo'e information it can stare. However tapes are 
imited in time. The more data on the tape, the lonyer the time it lakes 
to find the information. 

Tie programmer must try to minimize the time factor when working 
■A'i*h tape storage. One cemmon practice is to rend the entire cassette 
dalci file into RAM, then process i", and then re-write all the data on the 
tape. This allows vou to sari, edit, and examine your data. However, 
this limits the size of your files to the amount of available RAW. 

If your data file is larger thnn the nvnilnble RAM, it is prnbnhly time 
-o swrch to using theflopoy disk. The disk can read data at any position 
m the disk, without needing to read through al the ether date. You can 
write data over old data without disturbing the rest of -he file. Thai's 
why the disk is used for all business applications like edgers anc mail- 
ing lists. 

This PJ?INT# statement formats data just like the PSINT statement 
does All punctuation works the some. But remember, you're not work- 
ing with the screen now. Tie formatting must be done with the INPUT# 
statement canstantly In mind. 
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Consider the statement PRINT# 1, A$, B$, Cfc. When used with -the 
screen, the commas between the variable; provide enough blank space 
between items +3 format them into columns ten characters wide. On 
ccsserte, anywhere from 1 to 10 spaces will ba added, depending on 
the 'ength of the strings, This wastes space an your tape. 

Ever worse is what hapoens when "he INPUT# staremenT Tries to read 
these strings. The statement INPUT# I, A$, B$, C$ will discover no data 
for 6$ and C$. A$ will contain all th^ee variables, plus the spaces be- 
tween them. What happens? Here's a look at the tape file: 

AS="DOG" B$="CAT" C$="TREE" 
PRINT# 1, AS, B$, C$ 

1 2 3 A 5 6 ; 8 ? 10 11 12 13 M 15 16 17 16 19 20 21 22 23 24 25 
DOG CAT TREE RETURN 

The INPUT# statement works like the regular INPUT statement. When 
typing dcra into the IMPUT statement, the data items are separated, 
either by hitling the |jj3l^fl key '■'"' using commas +0 sopora-c them, 
The PRIMT# statement puts, a RETURN at the end of a line ]ust like the 
PRINT statement. A$ fills up with all three va ues because there's no 
separator nn trm tape between rhem, only after all 'hree. 

A proper separator would be a comma {,) or a RETURN on the tape, 
The RETURN code is automatically put at the end of a PRINT or PRINT # 
statement, One way to put the RETURN code between each item is to 
use only one item per PRINT# statement. A better way is to set a vori- 
cble to the RETURN CHR$ code, which is t_HR$;i3), or use a comma. 
The statement For this is R$- "/' s PRINT# 1 . A? R$ B$ R$ C$. Don't tse 
comTias or any other punctuation between the variable norr.es, since 
the Commodore 64 can teJI them apurt and they'll only use up spate in 
your program. 

A proper taps file looks like this: 

1 2 3 4 5 6 7 8 9 10 11 12 13 
DOG, CAT, T R E E RETURN 

The GET# jtntement uvill p rk data from the tape one character at a 

time. It will receive each character, Including the RETURN code and 

other punctuation. The CHR$(0) eoce is received rjs an empty string, not 
Q3 u one diumdei siring with a code of 0. If you try to use the A5C 
function on an empty string, yau get the error message ILLEGAL 
QUANTITY ERROR. 
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The line GET# 1, A$: A — ASC(A|) is commonly used in prcgrams to 
examine laps date. To avoid error messages, the line should be mod- 
ified to GET#1, A3: A= ASC( A$+ CHR$(0)). The CHR$(0) at the end 
acts as Insurance against empty strings, but doesn't affect the ASC 
fund ion when there ere other characters in A$. 



DATA STORAGE ON FLOPPY DISKETTES 

Diskettes allow 3 cliff e'ent forms of data storage. Sequential fifes are 
similar To Those on- tape, but several ran ran be used at the same. time. 
Relative files let you organize the data into records, and then read and 
replace individual reccrds within the file. Random files let you work wiih 
data anywhere on the disk. They are organised into 256 byte sections 
called bfocks, 

The PR MT# statement's limitations are discussed in the section on 
cassette tape. The same lim'taT'ons to formaT apply on the disk. 
RETURNS or commas arc needed to separate your data. The CHR$(0] is 
still read by the G£T# statement as on emp-y string. 

Relative and random files both make use of separate dcta and com- 
mand "channels." Data written tu the disk yues through I he duta chan- 
nel, where it s stored in a temporary buffer in the disx's RAM, When the 
record or block is complete, a commend is sen! through the cummund 
channel that tells the drive whe r e to put the data, and the entire suffer 
is written. 

Applications that require large amounts of data to be processed are 
best stored in relative disk files. These will use ihe least amount uf lime 
and provide the best flex bility for the programmer Your disk drive 
manual gives a complete programming guide to use of disk files. 
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THE GAME PORTS 

The Commodore 64 has two 9-pin Game Pu'ls which allow the use of 
joysticks, paddles, or a light pen. Each oor* will accept either one jay- 
stick or one paddle pair. A light pen can Lie plue.yed into Port A (only) for 
special graphic control, etc, This section gives you examples of hew to uis 
the joysticks and peddles from bo~h BASIC arid machine language. 

Ihe digital joystick is connected to CIA #1 (MOS 6526 Corrplex Intar- 
foce Adapter). This input/output device also handles the paddle fire but- 
tons and keyboard scanning, The 6S26 CIA chip has 16 registers which 
are in memory locations 56320 through 56335 inclusive !$DC00 to 
$DC0Ff, Port A dctct appears at location 56320 (DC0O) and Port B data 
is found at location 56321 ($DC01). 

A digi'ol joystick has nve distinct switches, four of the switches are 
used for direction and one of the switches is used for the fire button. The 
joystick switches are arranged as shown: 



FIRE 

(Switch 4) 



LEFT 

(Switch 2) 



(Top> 



UP 

(Switch 0) 



RIGHT 

(Switch 3.) 



DOWN 

(Switch 1) 

These switches correspcrd to the lower" 5 bits of the data in location 
56320 ui 56321. Nuimully llie Si[ is set 1o u one if u direction is NOT 
chosen or the fire button is NOT pressed. When the fire but-on is 
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pressed, the ait (bir 4 in this case) changes to a 0. To read the joystick 
fronr BASfC, thp following subroutine should be used: 



10 

20 

33 

40 

58 

60 

65 

OHO 

73 

30 

PUS 

9@ 

1100 

110 

120 
130 



SET UF DIRECTION STRING 



',»W H /"MW" 

r M~",. "SE? 1 



fi DIRECTION WAS 



FORK=0TO10:REM 

READER* <IO :NEMT 

IiflTH" 11 .. "H"., "£", ' 

UrTTFTSH", "","E", 

PRIMT^GOIMG. .. ". 

GOSUEiea^RErl RERD THE JOVSTICK 

IFDR*<JV)» H, *THENS8iREM CHECK IF 

SEN 

PRIMTBR*CJV>i"' ";=REi»1 OUTPUT WHICH DIRECTION 

IFFR«16THENS0:REM CHECK IF FIRE 3UTTQI-1 WftS 

HED 

PRINT" F 1 R -E ! I ! " : GOTOSB 

JVaPEEK < 56330 >: REM GET JOVSTICK VRLUE 
f-R'=.JVRNIIt6^REn FORM FIRE BUTTON STRTUS 
JV=13-'.:JV=IND15:''R3'1 FORM DIRECTION VRLUE 
RETURN 



NOTE: for the second joystick, lot JV - PEEK (56321). 



The values icr JV eorresoond to these directions; 



JV EQUAL TO 


DIRECTION 





NONE 


] 


UP 


2 


DOWN 


3 


— 


A 


LEFT 


5 


UP 8. LEFT 


6 


□OWN & 1EFT 


7 


— 


8 


RIGHT 


9 


UP S RIGHT 


10 


DOWN & RIGHT 
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A small machine coce routine which accomplisiss the some tnsk is as 

follows: 



SUTTON REflB 



im& .PAGE CTQYSTICK.O/SO JOYSTICK 
ROUT! WE 
ii3io ; 

1029 ,: AUTHOR - BILL HINIiORFF 

iB30 ; 

1940 DK»*Cli@ 

1050 DVNPCm 

1660 ^=*Ci":ei0 

1679 DJF5R LDR #SC09 

fi ONLVi 

10S9 BJRRB LOV #@ 

DECODES THE 

1090 LEW #0 

INPUT DRTH IN 

1 IBS LSR H 

LEAST SIGNIFICANT 

1110 SCS 5JR0 

SWITCH CLOSURE 

1 120 DEV 

IS CLOSED THEN IT 

1130 OJR0 LSR fl 

R SWITCH IS OPEN THEN 

1140 SCS 33JR1 

I"HE JOYSTICK DIR- 

1158 IHV 

FCRMPiftD, BACKWARD 

nee wri lsr r 

BITl-EHIKUHRII, 

1170 BC3 DJR2 

EiIT4=FTRE BUTTON. 

1189 DErt 
SONTFlIN 3'S COrlF'LiriEHT 

1190 DJS2 LSR fi 
*FF=-l, *e®=®, *8J=l. 

12130 3CS BJr?3 

a-ovE left'j.. 
I2i@ in* 

DV«-i <MCVE UP SCREEN? 

IS 20 DJR3 LSR fl 

DVsQ CNO V CHANGE!: , 

I23@ STK BX 

PC!-: I T [ ON caRRESPUMDS 

12*0 STV nv 

F)MJ THE HFCKWRRn 

1230 RT3 

SCREEN, 

1£60 i 

1270 ;flT RTS TIME THE CflF:RY FLFG CONTAINS THE FIRE 

BUTTON STATE - 

1280 ; I- C*l THEN BUTTON NOT PRESSED- If C=0 THEN 

PRESSED. 

1290 ; 

130B .EHC 
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(GET INPUT FROM PORT 
;THIS ROUTINE READS AND 
; JQVSTICK/FIREBUTTQN 
iTHE ACCUMULATOR. THIS 
•5 BITS COTTFIH THE 
: It-I-ORNPITIOH- IF =! SNITCH 
, PRDELCES R ZERO EIT. IF 
, IT FROEUCES F) ONE BIT. 
(ECTICNS FRE RIGHT, LEFT, 
;UIT3=R"GHT, KI~2=LEFT. 
,BIT0*FQRMflRB fiND 
JOT RTS TIME tl'rt AND DV 
; DIRECT: OH NUMBERS I.E, 
;liX*l (MOVE RIGHTS., DX«-I 
;BK»S <N0 K CHRN0E5. 
,'BY*1 (ROVE DOWN SCREENS, 
;THS FQRWARB JO'-'STICK 
1TG MCVE U= THE SCREEN 
i POSITION TO MOVE DCWH 



US 



PADDLES 

A paddle is connected to both CIA #1 and the SID chip (MOS 6587 
Sound Interface Device) ihrougr' a game porr. The paddle value Is read 
via tr-e SID registers 54297 ($D419) and 54298 ($D41A). PADDLES ARE 
NOT RELIABLE WHEN READ FROM BASIC ALONE!!!! The best way to LSe 
padd'ei, from BA5IC or mach re code, is to use the following machine 
language routne. . , . (SYS To it from BASIC then PEEK the memory 
locations used bv the sub-outine). 



leera 

; ***Lt:+.t : #*+++:ti: igm> ***:|i- 1.*:!.:^*** ******* *44*iM(#inMi4H|HMHtiila|i)M«i|Hk 
1018 >* FOUR PfTOSLE EEFD ROUTINE CCflN ALSO BE USED 
FCR TH0> 

1030 .: AUTHOR - BILL HIHIIURFF 
1040 P3RTH=$DC0e 
1050 CIEIfRA=*nC02 

iase siri=*ii493 

ie8d BUFFER *-*+! 
1690 PDLX *«*+-2 
lieu PDLV *=*+-2 
1110 BTNfi *=fc+l 
1120 BTN'B *=*+l 

H3E3 *s*scaa0 

1145 PDLRD 

1150 LBK 1*1 

OR TWO FlNflLOG .JOYSTICKS 

1160 PDLF.M 

ONE PAIR (CONDITION K 1S t, j 



1170 


SE J 




1130 


LDfl 


CIBERfl 


OF BBR 






1199 


STR 


BUFFER 


1200 


LHR 


tt*C0 


1210 


£TH 


CIBERH 


INPUT 






1220 


LBH 


isae 


1238 PDLRD 1 




1240 


STfl 


F3RTA 


FRIDLES 






1250 


LIlY 


4*60 


1260 PDLRB2 




127© 


HOP 




12SU 


EE'-' 




1290 


BPL 


PDLRB2 


13B0 


LDH 


S1TJ+25 


1310 


STFl 


PDLK..K 


1320 


LPFI 


SID-ISC 


13313 


STfl 


pdlv,>: 



FOR FOUR PfUBLES 
; ENTRY POINT FOR 



fJET CURRENT VALUE 



SBVE IT riUIRV 
SET PORT R FOR 



REDRESS R PHIR Or 



1-JFlIT A WHILE 



■GET X VALUE 



GET 



VRULJ1 
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1340 LBR PORTA i TIME TO ?ERD 

PfiSULE FIRE SUTT0H3 

135@ GRfl #*@@ .MAKE IT THE SRME 

PS OTHER PRIR 

13S0 STfl 3TMR , E IT £ is P33L ;>;. 

FilT 3 IB PIlL V 

12-71 LTJf'l *S4@ 

1380 HEX . ;HLL PR2P5 BONE? 

1330 EFL PXED1 ;Nn 

14013 L..CP BUFFER 

1410 STfl CIDERP ; RESTORE PREVIOUS 

VALUE OF BUR 

1. 420 LJ3P PORTfl+1 IFOR ZHl PAIR - 

1430 STF BTHB ;EIT 2 IC Pft_ x, 

:ett 3 is pel v 

1440 GUI 

14SE RTS 

1456 ,END 

ll-c paddles -nri ds -ecid .-5/ using the icllov/inc BASIC prcgrar 



10 C="l 2*4396 ; REM SET PADDLE ROUTINE STRRl 

U REM POKE IN THE PflBlL.E READING ROUTINE 

1 3 FOR I =>0TOr33 : RERDP, i POKED* I, ft'- NOT 

20 SVSC'REM CRLL THE; PADDLE ROUTINE 

30 PlsPEEKCC+2S7j;REH SET PRTJBLE ONE VHLLE 

4S P2=PEEK<C+238>:RE[1 " " TWO 

30 P3-PEEK«C+£3S> : REM " " THREE " 

SB P4*'P , EEK<C^£S©>!REM " " FOUR " 

Si REM RERfJ FIRE BUTTON STATU© 

52 Sl-PEEkXOSSl > ^.^PZEKZC+ZGSj 

7H PRINTPJ,,F2,P3,F4:RE11 PRINT PflBILE Vft.UES 

72 REM PRINT FIRE BUTTON STATUS 

73 PRINT ; FfWNT" FIRE R "; SI. "FIRE B v 132 
©O FrjRW«=i TOSS : N£KT: REM NRI.T Fi WHILE 

90 PRINT'IT : PRINT: GOTO 20:RErl CLERR SCREEN FIND 10 

miu- 

35 REM I.lRTH FOR MACHINE ZCEE. ROUTINE 

:, 0-3 IRTfl L62j 1 j 1 28.. 173 . 2 .. 22E , 1 4 I. .. B . 3 93 . 1 S3 . 1 92 , 14 1 , 

S.SEg'.ISS 1 

i 10 rPTftlSB.. I'M. ejtS£0j I. S3., 12S, £34, 136, IS, 25?, 17~i, 

25.212,15' 

128 DflTftJ ■ 192, 173, 26, 21S, IE?, 3, 193,, 173. 3; 220, 3, 123- 

1 4 1,5,193 

130 EflTfJ.S9^64,£02, 16,22S, 173,9,192, 141 .2.220,173. 

3,220, 14:. 

] 40 DP rBS , 1 513 , as , 95 
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LIGHT PEN 

The fight per input latches tie current screen position into « pair of 
registers [LPX, LPY) on a low-gning edge. The X position register 19 
($13) will certain the S MSB of the X position at the rime of transition. 
Since the X position is defined by a ."ilS-atnte counts {9 bits), resolution 
to 2 horizontal d^^s is provded. Similarly, the Y position is farched in its 
register 20 (3 14), but here 8 bits provide single roster resolution within 
the visible display. The light per latch may be triggered only once per 
frame, arid subsequent trggers within The same frcme will Jiaup no 
effect. Therefore, you must take several samples before turning the pen 
to the screen (3 or more samples average), depending upon the char- 
acteristics of your light pen. 



RS-232 INTERFACE DESCRIPTION 

GENERAL OUTLINE 

The Commodore 64 has a built-in RS-232 interface for connection to 
any RS-23? modem, p'inter, or ctner device. To connect a device to the 
Commodore 64, a I you need s a cable and a little bit of proyramming. 

RS-232 Oil the Commodore h& is set- up in the standard KS-232 for- 
mat, but the voltages are TTL levels (0 to 5V} rather than the normal 
R5-232 — 12 - o 72 volt range. The cable be-ween the Commodore 64 
and the RS 232 device should take cars of the necessary voltoge ecu- 
versions. The CommodDre RS-232 interface cartridge hendies this prop- 
erly. 

Tlie RS-232 interface software can be accessed from BASIC or from 
the KERNAL for machine language programming. 

RS-232 an tie BASIC level uses the ncmal BASIC commands: OPEN, 
CLOSb, CMD, INPUT#, GET#, PRINT#, ord the reserved variab e ST. 
INPUT# and GET# fetch data from the receiving buffer, while PRIINT# 
and CMD place date into the transmitting buffer. The use of these com- 
mands (and examples) will be describee in more deluil later in this 
cnapter. 

The RS-232 KERKIAL byle and bit level hcndlers run jnder the control 
of the 6526 CIA #2 device timers and interrupts. The 6526 chip gener- 
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cites NW (Won Maskable Interrupt) requests for RS-232 processing. This 
allows background RS-232 processing to fake place during BASIC and 
machine language programs. There are built-in hold-offs in the KERNAL, 
cassette, and seriai bus routines to prevent the disruption of data stor- 
age or transmission by the NMIs that arc generated by the RS-232 
royhfiS. During zassette or serial ous actMfffeS, data enn NOT be re- 
ceived from RS 232 devices. But because these hold-offs are only ocal 
[assuming you're careful about your programming) no interferencE? 
should result 

There are two buffers in the Commodore 64 RS-232 interface to help 
prevent the loss of data when trarsmitting or rocoVIng RS-232 informa- 
lion. 

The Commodore 61 RS-232 KERNAL buffers consist of Kvo first-in/ 
first-out (FIFO) buffers, each 256 bytss long, at the top of memory. The 
QPENing of on RS 232 channel a jtomcticolly allocates 512 bytes of 
memory far these buffers. If there is not enough free spece beyond the 
end of your BASIC program no error message will be printed, ano the. 
end of your program w II be destroyed, SO BE CAREFUL! 

These buffers ore automatically removed by using the CLOSE corn 
ma rid. 

OPENING AN RS-232 CHANNEL 

Only one RS-232 channel should be open ct any r : me; a second OPEN 
statement will cause the buffer pointers to be reset. Any characters in 
eirbe' the Tunsmit buffer or the 'eceivs ouffer will be lost. 

Up to 4 characters can be sent in the filename field. The First two are 
the control and command reyisler characters; ihe other two are re- 
servec for future system options. Baud rate, parity, and other options 
can be selected through this feature. 

No error-checking is done cr the control word to detect a non 
implemented baud rate- Any Illegal conlrul ward will cause IHe system 
output to operate at a very slow rct= (below 50 baud). 

BASIC SYNTAX: 

OPEN lfn,2,0,"<control -egisterXcommand registerXopt aaud 
lowXopt baud high>" 

Ifn — The tacica fie number (Ifn) then can be any number fron 1 
through '2&b. But be cware of the fact thai if yoj choose a logical -ile 
number that is greater ihcm 127, 1her a line feec will fellow all carriage 
returns. 
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STOP BITS - 

0-1 STOP 3IT 
1-2 STOP BITS 



WORD LENGTH' 



BIT 


DATA 
WORD LENGTH , 


6 


5 








8 BITS 





1 


7 BITS 


1 





6 BITS 


- 


1 


5 BITS 



UNUSED 



[3]@00 


BAUD RATE 





c 





USER RATE [Nl] 





c 


1 


50 BAUD 





1 





75 


D 


1 


1 


110 





1 c 





134.5 





1 c 


1 


150 





1 1 





300 


D 


1 1 


1 


600 


1 


t 


1 


1200 


1 
1 


£ 


J c 


- 


(1500) 2400 


j 1 





2400 


1 


1 


1 


3600 [Nl] 


1 


1 t 


) 


4QO0 [Nl] 


1 


1 ( 


1 1 


^200 [Nl] 


1 


1 ■ 





9600 [Nl] 


1 


1 ' 


1 


19200 [Nl] 



Figure 6-1. Control Register Map. 



<eontrol register' 1 — Is a single byre churucte- (see Figure 6-1, Con- 
trol Register Map) required to specify the baud rates. If the lawer 4 bits 
of The baud rate is equa to zero (0), The <opt baud lowXopt baud 
high> characters give you o rate based on the Following: 

<opt baud law> = <system frequency/rate/2— lOC-<opt oaud 

high>*S56 

<opt baud high> = INTttsystem frequency.' , raTe^2-100)/256 
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PARITY OPTIONS- 



BIT BIT 
7 I 6 


BIT 

5 


OPERATIONS 


- 


- 





PARITY DISABLED, NONE 
GCNEriATEDy RECEIVED 








1 


ODD PArtlTY 
RECEIVER'TRANSMITTER 





1 


1 


EVEN PARITY 
RECEIVERrRANSMITTER 


1 





1 


MARK TRANSMITTED 
PARITY CHECK DISAELEO 


1 


1 


1 


SPACE TRANSMITTED 
PARITY CHECK DISABLED 



DUPLEX- 



0-FULL DUPLtX 

1-HALF DUPLEX 

UNUSED' 
UNUSFD- 



UNUSED 



"-HANDSHAKE 

0-3 LINE 
1-X LINE 



Figure 6-2. Command Register Map. 

The formulas above are based oi the fact that; 

system irequency = 1.02273E6 NTSC (North American TV stan- 
dard) 
= 0.9S52SE6 PAL (U.K. and most European TV 

standard) 

command register> — Is a single byte character (see Figure 6-2, 
Command Reg ster Map) thai defines othe' terminal parameters. This 
character is NOT nec.iii'ed. 
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KERNAL ENTRY: 

OPEN ($FFCO) JSee KF3NAL sperifiratinns for more information or 
entry conditions and instructions.) 



IMPORTANT NOTE: In a BASIC program, the RS-232 OPEN eomnnand should be per. 
formed before crsetlng ony variables of arrays because on automatic CLR is par- 
formed when an RS-232 chamel is OPENed (TMi it due to the a location of 512 b^et 
at the top o- memory.) Alse remembci *hot youi piogrom w'll be destroyed if 512 
bytes af space are not avai able at the time of the OPEN stareiTient. 



GETTING DATA FROM AN RS-232 CHANNEL 

When getting data frcm an RS-232 channel, the Commodore 64 re- 
ceiver buffer will hold up to 255 characters before the buffer overflows. 
This is indicated in -he RS-73? status word (ST in BASIC, nr RSSTAT in 
machine language). If an overflow occurs, then all characters received 
during o full hjf*er rendition from that point on, are Inst. Obviously, it 
pays to keep the buffer as clear as possible. 

If yet wisn to -eceive RS-232 data at high speeds (RASIC con only go 
so fast, especially considering garbage ca'lects. This can cause the re- 
ceiver buffer to overflow), you will have to tse machine language 
routines to handle this type of data burst. 

BASIC SYNTAX: 

Recommended = GbT#lfn, < string variable > 
MOT Recommended; lNPUT#lfn ^variable list> 

KERNAl ENTRIES: 

CHKIN (SFFC6) — See Memory Map for more information en enfry and 
exit condnons. 

GETIN ($FFc4i — See Memory Mop for more information on entry and 
exit conditions. 

CHRIN {JFFCF) — See Memory Mao for more information an enrry and 
exit condi'ions. 
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NOTES 

If il '.■ ward '/' [ I' is b&a than 8 b Is, all unuftGpJ bif(s) will Le ussiyneJ a /alue of 
zero. 

If o GET# does not find any caio lr Ihe buffer, the character "" (o nu I) is feumed. 

rf IMfUW is used, then the system wll hcng in o waiting condition until o nan-null 
character and c fallowing carriage retjrn is received, Therefore, if the Clear lo Send 
(CTS) a' DotaSsette Ready (DSR) linsfej disappear during character MNFUT#, the sys- 
tem will hang in a BESTORF-itnly itata. This b why the INPUT* and CHRIN mutines 
are NOT recommended. 

The routine CHKIN handle* the »ine handihalc* which folbuus the EIA stardard 
(August 1979) for RS-S32-C interfaces. (The Request T Q Send (RTS), CTS, and Re 
ceiled line nigral (DCD) lin^s aft- fmpJenien-ed witi the Commodere 64 computer 
dsfinsd as'the Da'a Terminal device.) 



SENDING DATA TO AN RS-232 CHANNEL 

Wher sending data, rhe output buffer can hold 255 characters before 
a fall buffer hold-off occurs. The system wi I wait in the CHROUT rout 're 
unlll luiisrnibs'oti is alluwed ui lliir : : . I. and JUDITH keys 

are used to recover the system through a WAWM START. 

BASIC SYNTAX; 

CMD If n — acts some as in the BASIC specifications. 
PRINT#lfn J <vcjriabJe list> 

KERNAL ENTRIES: 

CHKOUT ($FFC9) — See Memory Wop for more information on entry 
nrd exl* conditions 

CHROUT (3FFD2) --See Memory iV.ap for more information on entry 
rnndiTiarlS. 
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IMPORTANT NOTES: There is no carriage return dclaf buEh intc the output channc-l. 

This means that a norma- 3S-232 printer cannot correctly prlnr, unless some farm gf 
hold-uff (ijikinci rhe Commodore £4 to waitr or internal byfFerirg ^ implemented by 
the printer, The hold-off con eos'ly be implemented in you- program. If a CT5 (x-line) 
harldillCike n ifripJ«fnsj'ile?J, ifie Cururrjuduie Ci4 Ln.f r er vvfli fill, und I hen hud-uff murs 
output until transmission fs p lowed by ihs RS-232 device, K-lfne hendshaking is a 
handsheke routine That uses multi-lines fo' receiving and transmitting date. 

The routine CHKOUM ficwcles the x-fine ticrndshafce, which follows the EIA stanocrd 
(August 1979)^1 B5-232-C interfaces. The RT5, CT5, anc JCD lines are implemented 
with *h& CommaHor^ iSi ripfinPri as the Dnte Terminal Device. 



CLOSING AN R5-232 DATA CHANNEL 

Closing an R5-232 file discards all data in the buffer at the time of 
execution (whether ot not it had been trcna miffed or printed out), stops 
all RS-232 transmitting and receiving, sets the RTS and transmitted dato 
(S 0J |) lines high, and ismores both RS-232 buffers. 



BASIC SYNTAX: 
CLOSE l-fn 

KERNAL ENTRY; 

CLOSE [$FFC3] — See Memory Mnp for more information on entry nnrf 
exit condhiors. 



NOTE; Care should be 


tCISl^l 


tc> *jn&m's til" dult 


is trans-nitred 


before 


das 


IKl 


rhe 


channel. A wgy to chad*, this 


fi g 1 1 1 


BAS.C is: 












TOO 55- SI: IF<SS- 


= OR SS 


= 8) THEN 


00 










110 CLOSE Ifn 
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Fable 6-1. User-Port Lines 



[6526 DLVICE #2 Le-c 


, $DD0O-$DD0F) 




PIN 
ID 


6526 
ID 


DESCRIPTION 


EIA 


ABV 


IN/ 

our 


MODES 


C 


PBO 


RECEIVED DATA 


;bbi 


S|n 


N 


1 2 


D 


F*B1 


REQUEST TO SEND 


iCA) 


RTS 


OUT 


1*2 


E 


PB2 


DATA "ERW HAL READY 


(CD) 


DTR 


OUT 


1*2 


F 


PB3 


RING INDICATOR 


CCB 


Rl 


IN 


3 


H 


PB4 


RECEIVED LINE SIGNAL 


;cf; 


DCD 


IN 


2 


J 


PB5 


UNASSIGNED 


L J 


XXX 


IN 





K 


PB6 


CLEAR TO SEND 


ICES} 


CTS 


IN 


2 


L 


PD7 


DATA SET READY 


(CQ 


DSR 


IN 


2 


B 


FLAG2 


RECEIVED DATA 


|BB) 


Sin 


IN 


1 2 


M 


PA2 


IHANSAMIIfcD DA T A 


(BAj 


S^uL 


OUT 


1 2 


A 


GND 


PROTECTIVE GROUND 


<AA} 


GND 




1 2 


N 


GND 


SIGNAL GROUND 


(AB) 


GND 




1 2 3 


MODES: 










1) 3-LINE INTERFACE (S rr ,,S 0Ut ,GND) 










2) X-LINE INTFSFACF 










3) USER AVAILABLE ONLY [Unused/un 


mplerrw 


:nted in 


code.) 




* These lines ere held high during 3- 


LINE tn 


:de. 







[7] [6] [5] [4] [3] [2] [lj [0] [Machine Lang.— RSSTAT 

: :_PARITr bRKOk HI I 

: FRAMING- ERROR BIT 

RECEIVER BUFFER OVERRUN BIT 

RECEIVER BUFFER— EMPTY 

(USE IO I LSI AHbK A GET#) 

CTS SIGNAL MISSING BIT 

UNUSED BIT 

-DSR SIGNAL MISSING BIT 

BREAK DETECTED BIT 



Figure 6-3. RS-232 Status Register. 
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NOTiS: 

If The BIT=0, Then na error has beer deTected. 

The RS-£Z2 status register can be reac from BASIC using 'he varable Sr. 

If 5T is reod by BASIC or by using 1he KEKNflL KtAKiJ routire the K5-232 Btatis 
word s cleared when yoj exit. It multiple uses ot the STATUE ward are necessary the 
5T shnuld bp assigned In nrtn'bpr vnriflhlp Fftr fc*nrnplet 

SR=ST: REM ASSIGNS ST TO SR 

The P^-232 itatus h read [.and c seared) -only whter the RR-?39 rrrinrir*! wns the Inn* 
^Kt^rnn! I/O UKed. 



SAMPLE BASIC PROGRAMS 



10 RE-1 THIS PROGRAM SENUi FiND <ECEI"E5 DFTfl 
TQ/FRQM fi SILiNT 70B 

11 REM TERMINAL MODIFIED FOR PET ASCII 

£8 REN TI SILENT 700 3ET-UF : 360 BAUD* 7- BIT ASCII, 

MARK PflRITY< 
2: REM FULL DUPLEX 

33 REM SfiHE SET-UP AT COMPUTER USING 3-LINE 
INTERFACE 

lCiB OPEN £,2i3..CHR*C5*32)+CHR*<a2+iaS>;R£H OPEN 
THE CHANNEL 

110 GET#2,H*'REPl TURN OK THE RECEIVER CHANNEL 
(TOSS fl HULL) 

209 REM MRIN LOCP 

210 GET B* REM GET FRJP1 CQMFUTER KEYBOARD 
2£9 IF E*0"" THEN FRINTHSj E$.-REM IF A KEY 
PRESSED.. SEND TO TERMINAL 

£50 GET#2,C*'REM GET A KEV FROM THE TERMINAL 

240 PRINT B$.;C*; :REM ~'RIMT HLL INPUTS TO COMPUTER 

SCREEN 

253 SR=ST; IF 5R=B OR 3F=S THEN 200: REM CHECK 

STATUS.* IF GOOD then continue 

300 SEN ERROR REPORTING 

310 PRINT "ERROR- " ; 

320 IF SR RHD 1 THEN PRINT " PARITY" 

330 IF SR HMD 2 THEN PRINT "F^flME" 

340 IF SR AND 4 THEN PRINT "RECEIVER BUFFER FULL" 

358 IF SR AND 128 THEN PRINT "BREAK" 

350 IF (PEEK<573) AMD 1; THEN 356 -REM WHIT JNTIL 

FILL CHARS TRANSMITTED 

370 CLOSE 2 END 
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10 REM THIS PRJGRflM SENDS HND RECEIVES TRUE ASCII 

IIITTFl 

L00 OPEN 5,»2*3^CHR*C6) 

119 DM FK<235>/T8<2553 

560 FOR J=32 TO 64iTK<J>=J ; Ntn. 

219 TKtl3j = 13:T>iC20>=8:RV=lS:CT=0 

220 FDR J=S5 TO S& ■ K=J+52 : TY.( J)*K : NEXT 

230 FOR J»9I TO ss;t{s<j)«j:next 

249 FDR J* 193 TO 2AS:K"J~12S: Ttfc;, T )=K' NEXT 

25FJ TM<l46^lS« , TK<i33>"16 

260 FOR >8 TO 255 

£79 k=t;:cj; 

SS0 IF K-OQTHEN Ftf<K>«*J'FK<K+i2§W 

298 HEXT 

300 PRINT " 'CHRSU473 

310 GET«5,A* 

3£@ IF R*=""OR ST08 THEM 36E 

336 PRINT " "CHR*<15?>;CldR*<FSi£FlSCCR$?>>; 

349 IF F;i ( FISC < FW ) 5 «34" THEN P0KE2 12:3 

350 GOTO 310 

3^0 PRINTCHR*<RV>" "CHR*C 157} ; CHR*<"14£5 ; ■ GET R* 

370 IF FWO'"'THEMPRIMT*a^CHR*i;T5i!;«SC£fl*WJi 

380 CT*CT*1 

336 IF CT-S THEHCT=0:RV=154-RV 

410 OOTOG10 

RECEIVER/TRANSMITTER BUFFER BASE LOCATION 
POINTERS 

$00F7 — RIBUF — A twa-byte pointer to the Receiver Buffer base loca- 
tion- 

$OOF9-ROBUF — A two-byte pointer to the Transmitter Buffer base 
ocation. 



The two locations above are set up by the OHfcN KbKIMAL routine, each 
oointing to a different 256-byte buffer. They are de-allocated by writing 
a zero into the high order bytes (JOOFS and $OCFA), which is done by the 
CLOSE KERNAL entry. They may also be allacated/de-ollocated by the 
machine language programmer for his/her own purposes, removing/ 
creating only the ouffer(s) required. When using □ machine language 
program that rlloraTes ihese buffers, care must be taken to make sure 
•hat the top of memory ooinlers stay correct, especially if BASIC pro- 
grams are f> x peered to run a' the same rime. 
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ZERO-PAGE MEMORY LOCATIONS AND USAGE FOR 
RS-232 SYSTEM INTERFACE 

$00A7-INBIT- — Receiver input bit temp storage. 

$00A8-BITCI — Receiver bit count in. 

$00A9-RINONE — Receiver flag Start bit check. 

$OOAA— RIDATA — Receiver byte buffer/assembly location. 

$0OAB-RIPRTY — Receiver parity bit storage. 

$00B4-B1TTS — Transmitter bit cuunl uul. 

$00B5-NXTBIT — Transmitter next bit to be sent. 

$00B6-RODATA — Transmitter byte buffe7disasiembly locatiun. 

All the above zero-page locations are used locally and are only given 
cis a guide to understand the associated routines. These canno* be used 
directly by the BASIC or KERNAL level programmer to do R5-232 type 
things. The system R5-232 routines must he irseri 

NONZERO-PAGE MEMORY LOCATIONS AND USAGE FOR 
RS-232 SYSTEM INTERFACE 

General RS-232 storage: 

$0293-M51CTR — Pseudo 6551 control agister (see Figure 6-1). 

$0294-M51COR — Pseudo 6551 command -egister (see Figure 6-2). 

$0295-M5TAJB — Two bytes fol owing the control and command 
registers in the file name field. Theie locations contain file 
baud rate for the start of the bit test during the interface 
activity, which, in turn, is used to calculate baud rate. 

$0297-RS5TAT — The R5-732 status register (see Figure 6-3). 

$0293— BITNt/M — The number of bits to be sent; received. 

$Q299-BAU£>OF — Two byres that are equal to the T'me of one bit 
cell. { Based on system clock/baud rate) 
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$029B-RIDBE — The byte i/idex to the end of trie receiver FIFO 

buffer. 
$029C-RIDBS — The byre inoex to the start of the receiver FIFO 

buffer, 
$029D-ROQB$ — The byte index to the start of the transmitter FIFO 

buffer, 
$C29E-RODBE — The? oyte indsx to the end of the transmitter FIFO 

buffer. 
$02A1-ENABL — Ho!ds current active interrupts In the CIA #2 ICR. 

When bit 4 is turned on means that the system is waiting for 

The Receiver Edge. When bJT 1 Is turned on then the system is 

receiving data. When bit is turned on thcr. the system is 

transmitting data, 

THE USER PORT 

The jser porr is meant to connect the Commodore 64 to the outside 
world. By using the lines available at this port, you can connect the 
Commodore 64 to a printer, a Votrax Type and Talk, a MODEM, even 
another computer. 

The purl un lli« C(jmr;iodure 64 is direclly connected to one of the 
6526 CIA chips. By programming, the CIA will connect to many other 
devices. 

PORT PIN DESCRIPTION 



1 Z 3 4 5 C 7 8 9 10 11 12 



ABCDEFHJKLMN 
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PORT PIN DESCRIPTION 


PIN 


DESCRIPTION 


NOTES 


TOP SIDE 


1 


GROUND 




2 


+ £V 


(100 mA MAX.) 


3 


RESET 


By grcurding This pin, the Commodore 
64 will do a COLC START, resetting 
completely. The pointers to a BASIC 
program will be reset, but memory will 
not be cleared. This is also a RESET 
output for the external devices. 


d 


CNT1 


Seriq port counter from CIA #1 (SEE 

CIA specs;. 


5 


SP) 


Serin port from CIA #1 (SFE 6526 CIA 
SPECS). 


6 


CNT2 


Seria port counter from CIA #2 (SEE 
CIA SPECS). 


7 


SP2 


Serial port from CIA #1 (SEE 6526 CIA 
SPFCS). 


8 


PC2 


Handshaking line from CIA #2 (SEE 
CIA specs;. 


9 


SERIAL 


This pin is connected to the ATN ine of 




ATM 


the serial bus. 


10 


9 VAC 1 phase 


Connected directly to the Commodore 


11 


9 VAC-pf-ase 


64 transformer (50 mA MAX.). 


12 


GND 




BOTTOM SIDE 


GND 


The Commodore 64 gives you control 


A 


B 


FLAG2 


over PORT B on CIA chip #1. Eight 


C 


PBO 


lines for input or output arc available, 


D 


PD1 


as well as 2 lines for handshaking with 


E 


PB2 


on outside device. The I/O lines for 


F 


PB3 


PORT B are controlled by two loca- 


H 


PB4 


tions. One is the PORT itself, and is lo- 


J 


PB5 


cated at 56577 (SDD01 HEX), Naturally 


K 


PB6 


you PEEK ;tto read an INPUT, or POKE 


L 


PB7 


it to set an OUTPUT. Each of the eight 


M 


PAZ 


I/O lines can be set up as either an 


N 


©NO 


INPUT or an OUTPUT by setring The 
DATA DIRECTION REGISTER properly. 



360 



iHPUt,outPVT ejiJipE 



The DATA DIRECTION REGISTER has its location of 56579 ($DD03 
hex!. Each of the eiuhl lines in I he PORT has a BIT in the eight-bit DATA 
DIRECTION REGISTER (DDR) which controls whether that line will be an 
input or an output. If a bit in the DDR is a ONE, the corresponding line 
of the PORT will be an OUTPJT. If a bit in the DDR is a ZERO, the 
corresponding line of the PORT will be on INPUT. For example, if bit 3 of 
the DDR is set to 1, then ,ine 3 of The PORT will be an output. A further 
example; 

If the DDR s set like this: 

BIT #= 7 6 5 4 3 2 1 
vALUE: 1110 

You can see that lines 5,4, and 3 will fie outputs since tho3s bits are 
ones. The rest of the lines will be inputs, s'nce those lines ore zeros. 

To PEEK cr POKE tne USER port, It is necessary to use both the DDR 
and the PORT itself. 

Remember that the PEEK and POKE statements want a numoer from 
f)— 255. The nuinhprs given in the example must be trans a red into dec- 
imal before they can be used. The value would be: 

2* 4- 2* + 2 3 = 32 + '6 + 8 = 56 

Notice *hat the bit # for the DDR is the same number that = 1 raised to 
u power lo lurn 1he bit value on, 

[16 = 2t4 = 2X2X2x2, 3 = 2j3 = 2X2X2) 

The two other lines, FLAG1 and PA2 are different from the rest of the 
USER PORT. These two lines one mainly for HANDSHAKING, and are 
programmed differently from port B. 

Handshaking is needed when two devices communicate. Since one 
device may run at a different speed tian another device it is necessary 
tc give the devices some way of knowing what the other device ts doing. 
Even when the devices are operating at the same speed, handshaking is 
necessary to let the rjrher knew when data is to be sent, and if it has 
been received. The FLAG1 line has specicl characteristics which make it 
well suited for handshaking. 

-LAG1 is o negative edge sensitive input which can be used as a 
general purpose interrupt Input. Any negative transition on the FLAG line 
will set the FLAG interrupt bit. If the FLAG Interrupt is enabled, this will 
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cause an INTERRUPT REQUEST. If the FLAG bH is not enabled. It can be 
polled from *he interrupt register under program control. 

PA2 is bit 2 of PORT A of the CIA. Jt fs controlled like cry other bit in 
the port. The port is JoccTed at 5657(5 (SDDQO). The data direction regis- 
ter is located ot 5657B ($DD02.; 

FOR WORE INFORMATION ON THE 6526 SEE THE CHIP SPECIFICA- 
TIONS IN APPENDIX M. 

THE SERIAL BUS 

The .Sena! ous is a daisy chain arrangement designed to let the Com- 
modore 64 communicate with devices such as the VIC- 1 541 DISK DRIVE 
and the VIC-1525 GRAPHICS PRINTER. The advantage of the serial bus 
is that more ihcn one device can be connected to the port Up To 5 
devices can be connected to the serial bus at one time-. 

There are three types of operation over a serial bus — CONTRO-, 

TALK, and LISTEN. A CONTROLLER device is one wnich controls operation 
of the serial bus, A TALKER transmits dale ontD the bus, A LISTENER 
receives data from the bus. 

Trie Commodore 64 is the controller of the bus. It clso acts OS o 
TALK.EK (when sending data to the prnter, for example) and as a LIS- 
TENER (wher loading a program from the disk drive, for example). 
Other devices moy be either I I5TENER5 (the printer), TOIKERS, or both 
(the disk drive). Only the Commodore 64 can act as the controller. 

All devices connected on the serial bus will receive nil the dtitci 
transmitted over the bus. To al ow the Commodore 64 to route data to its 

intended destiration, each device has a bus ADDRESS. By using this 
device address, the Commodore 64 can control access to the bus. Ad 
dresses on the serlol bus range from 4 to 31, 

The Commodore 64 can COMMAND o particular device to TALK or 
LISTEN. When the Commodore 64 commends a device To TALK, The de- 
vice wi I begin putting data onto the serial bus. When the Commodore 
64 commands a device To LISTEN, the device addressed Will get ready tc 
receive data (from the Commodore 64 or f rom another device on ihe 
bus). Only one device can TALK on lie bus ul u time-; otherwise,, the dulu 
will collide and the system will crash in confusion However,, any number 
of devices car LISTEN at The same time To ane TALKER. 
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COMMON SERIAL BUS ADDRESSES 



NUMBER 


DEVICE 


4 or 5 
S 


VIC-1525 GRAPHIC PRINTER 
VIC- 1541 DISK DRIVE 



Other device addresses nre possible, fcach device has its own ac- 
dress, Certain devices (like tne Commodore 64 printer) provide a choice 
between two add'esses For the convenience of the user. 

The SECONDARY ADDRESS is to let the Comrncdore 64 Irunsrnit setup 
information tc a device. Hor example, to OPEM a connection on the bus 
to the printer, and have it print in UPPER/LOWER tose, use the following: 

OPEN 1,4,7 

where, 

1 is ths logical file number (the numoer you PRINT# to), 
4 is the ADDRESS of the p-inrer, and 

7 i; the SECONDARY ADDRESS that tells the printer to go into UPPER/ 
LOWER case mode, 

There are 6 lines used in serial bji operation — 3 input and 3 output. 
Tie 3 input lines bring data, control, and timing signals into the Com 
modoe 64. The 3 output lines wsnd duft;, control, gnd tirring signals 
from the Commodore 64 to external devices on the serial bus. 



SERIAL BUS PINOUTS 



PIN 


DESCRIPTION 


1 


SERIAL SRQ IN 


2 


GISD 


3 


SERIAL ATN IN/OUT 


4 


SERIAL CLK IN/OUT 


5 


SERIAL DATA IN/OUT 


6 


NO CONNECTION 
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SERIAL SRQ IN: (SERIAL SERVICE REQUEST IN) 

Any device on the aerial bus can bring this signal LOW when It re- 
quires attention from the Commodore 64. The Connrrodore 64 will then 
take care of the device. (See Figure 6-4), 



BY t SlNT LNDER ATTENTION (TO UtVIUbSh- 



i- 



NORMAL 
DATA BYTES 



ATN 



I 



CLOCK 
DATA 






^iruin_n_riri_nii 
muMinuiMiir 



Jr„L 



MSB 
UT F J 



LSB 

DA I A VALID 
LISTENER READY-FOR-DATA LISTENER DATA-ACCEPTED 

END-OR-IDENTIFY HANDSHAKE (LAST BYTE IN MESSAGE) 



Tnh 



ATN 



"ALKER REAOY-TO-SEND 
1 



ECseE nnnn r 



TALKER SENQNG 



DATA LillsJleJLlJ L 



H- t d 



MSB 



u 



injijinjwui \z 

T s-H-r-T v 



- T RY 



J Tp U4-T FR 



| LISTENER READY-FOB-DATA 
EOI-TIMEOUT HANDSHAKE SYSTEM LINE 

LISTENER READ V -FOR.OATA RELEASE 

TALK-ATTHNTION TURN AnOUND iTALKCFI AND LISTENER nEVEPSEC} 



ATN 



^^ JLTUUL 



I -H T R f*p T DC T DA 

DATA LiJLilleJlli I Tt < 

MSB 

lT F l 



DEVICE ACKNOWLEDGES IT IS NOW TALKER 
TALKE=t READY -TO-SEND 



'\U+Tv 



RyLJLdLyLiJyLiJLJ L 

LSD MSB 

Jt m L _j Tf 1- 



READY FOR DATA 
BECOMES LISTENER CLOCK. = HIGH, DATA LOW 



Figure 6-4. Serial 
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SERIAL ATN IN/OUT: (SERIAL ATTENTION IN OUT} 

The Commodore 64 uses this signal tg ^art a command sequence for 
a device on The serial bus. When the Commodore 64 brings this signal 
LOW, alf other devices on the bus star listening foe the CorYirnodore 64 
to transrrit an nc.dress. The device addressed must respond in a preset 
period of time; otherwise, the Commodore 64 will assume that rh# de- 
vice nddrpsRpd is nnr or the bus, and will retu'n an error in the STATUS 
WORD, (See figure 6-4). 



TALKER READY-TO-SENC 

TALKF3 SENDING 



-IT 



liiRjirLnjuui—j^^ 



IblbJldUlliJlsilBlLiJ L 



- 1\ 



hi 



LSE 
C ATA VALID 

T 

LISltNbH KtADK-hOR-DATA 



MSB I 

JTpLJthI- 
listener data-accepted 



SERIAL BUS TIMING 






Description 


Symbol 


Mln. 


TVB. 


Max. 


ATM RESPONSE (REGUREOi 1 


Tat 


— 




■iQCQit 


LlS"ENEP HOLD-OFF 


t h 





— 


CO 


NON-tUI HtSPQNSE TO RFD 2 


ME 


— 


40/1$ 


20C/is 


BIT SET-UP TALKER* 


'w 


stops 


70/l.s 


— 


DATA VCD 


Ty 


2C/is 


20/is 


— 


FRAMF HANDSHAKE' 3 


T F 


J 


20 


IOO&71S 


FRAME TO RELEASE OF ATM 


Tr 


Sdfia 






BETWEEN GVTESTIWE 


T BB 


10D ( iS 


— 


— 


FHI KFSPUNSt ITME 


TY6 


20J|I5 


£5Qps 


— 


EOI RESPONSE HOLD TIMC S 


T t | 


GOfiO 






TALKER RESPONSE LIMIT 


T R" 


□ 


30jta 


Bu>S 


HYIb-AO*.NOWLED6E J 


Trr 


20^5 


30/ts 


— 


TALK-ATTENTION RELEASE 


Ttk 


20>s 


30/ts 


100/iS 


TALK-ATTENTION 4CKNOWLEDGF 


T DC 


U 


— 


— 


TALK-ATTENTION ACK. HOLD 


Tra 


Wpa 


— 


— 


EOI ACKNOWLEDGE 


t F r 


60/;s 







Notes; 

1. II maximum time exceeded, device rot present error. 

2. II maximum time exceeded, EOI response required 

3. n maximum time exceeded, f'ame error, 

4.Tv sncl Tp R mirimum must be BO/15 forexlenal devee to bo a :alkw. 
5. T E! miniTium rrust b#80j*S for external device lo be a listener 



Bus Timing. 
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SERIAL CLK IN/OUT: (SERIAL CLOCK IN OUT) 

This signal is used for timirg the data sent on the serial bus, (See 
Figure -6-4). 

SERIAL DATA IN/OUT: 

Data on the serial bus is transmitted one bit at a time on this line. (See 
Figure 6-4.) 

THE EXPANSION PORT 

The expansion connector is a 44-pin (22/72) female edge connector on 
the back of the Commodore 64. With the Commodore 64 facing you, the 
expansion connector is on the far right of the back of the computer. To 
use the corrector, o 44-pin (22/22) male edge connector is required. 

This port is used for expansions of the Commodore 64 system which 
require access to the address bus or the data bus of the computer. 
Caution is necesscry when using the expansion bus, because it's possi- 
ble to damage the Commodore 64 by a malfunction of your equipment. 

The exporsion bus is arranged as fo lows: 

112\ K 1918 !?16 15 U 13 1J 11 10 9 a ? « 5 * 3 S 1 



ZYXWVUTSRPNMLKJHFEDC-O* 

The s'gnals available on the connector ere as follows: 



NAME 



PIN 



DESCRIPTION 



GND 

+ 5 VDC 

+ 5 VDC 

IRQ^ 

R/W 

DOT 

CLOCK 

l/Ol 

GAME 



EXfiOM 
1/02 



1 System ground 

2 (Total USER PORT and CARTRIDGE devices can 

3 draw no moie than 450 mA.) 

4 Interr upt R equest line to 6502 (active low) 

5 j Regd/Wnle 



6 

7 
8 
9 

10 



8,16 MHz video dol duck 

I/O block 1 <g) $DE00-$DEFF (active low) unbuffered I/O 

active low Is ttl nput 

active lovv Is ttl input 

I/O block 2 @ SDFO0-$DFFF (active low) buffed Is ttl 

output 
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PIN 



DESCRIPTION 



ROMH 
NMI 



1 



unbuffered, 1 Is ttl load max 



SK decoded RAM/ROM blocK @ $8000 (actve low) 

buffered Is ttl output 

Bus available signal from -the VIC-ll chip 

unbuffered 1 Is loac mux. 

Direct -nemor/ access rsquest lirie [active ow input) 

Is ttl input 

Data bus bit 7 

Data bus bit 6 

Data bus bit 5 

Data bus bil 4 

Date bus bit 3 

Datu bus bit 2 

Date bus bit 1 

Date bus bit 

System ground 

8K decoded RAM/ROM block @ tEOOO buffered 

6502 RESET pin 'active low) buff'ed ttl out/unbuff 'ed In 

6502 Non Maskable Interrupt (drive low) buff J ed ttl out, 

urbuff'ed In 

Phase 2 system clock 

Address bus bit 15 

Address bus bi1 14 

Address bus bit 13 

Address bus bit 12 

Address bus bit 1 1 

Address bus bit 10 

Address bus bit 9 

Address bus bit 8 

Address bus bit 7 

Address bus bit 6 

Address bus bit 5 

Address bus bit 4 

Address bus bit 3 

Address bus bit 2 

Address bus bit 1 
Address bus bit 
System ground 



, unbuffered, 1 U Hi load mox 



Overbur means active low 
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Following is a description of some important lines en the expansion 
nrjrt; 

Pins 1 ,22,A,Z are connected to the system g'ound. 

Pin 6 is the DOT CLOCK. This is the S.lS-MHz video do^ clock. All 
system timing is de'ivsd from "his elacs. 

Pin 12 it the BA (BUS AVAILABLE) signal from rhe VIC II chip. This line 
will go low 3 cycles before the VIC-II takes over rhe system busses, and 
remains low until the VIC II is finished fetching displcy information. 

Pin 13 is the DMA (DIRECT MEMORY ACCESS) line. When this line is 
pulled low, the address bus, the data bus, anc the Read/Writs line of 
the 6510 processor chip enter high-impedance state mode. Tiis allows 
an external processor to take control of the system busses. This line 
should only be pulled luw wherv I he d>2 clock is taw. Also, since ihe 
VIC-II chip will continue to perform display DMA, the exte/nal device 
rrust conform to the VIC-II timing (See VIC-II timing diagram.} This line 
is pulled up on the ComriDdore 64 



Z-80 MICROPROCESSOR CARTRIDGE 

Reading 'his book and using your compute' has shown you just how 
versatile yojr Commodore 64 really is. But what rrakes ths machYie 
even more capable of meeting your neocs s the odditior of peripheral 
equipment. Peripherals are things like Datassette" recorders, disk 
drives, printers, and modems. All these items can be added to your 
Commodore 64 th'otgh the various ports and sockels on the back of 
your macnine. The thing that mckes Commodore peripherals so good is 
the fact that our peripherals are "intelligenl." Thai meaiii thai they dor ' r 
take up valuable Random Access Memory spoce when they're in use. 
You're free to use oil 64K of memory in your Commodore 64, 

Another advantage of your Commodore 6A is the fact most programs 
yoj write on your Commodore 64 today will be upwardly cornpa'iole 
with any new Commodore computer you buy in, trm f itur*. This is par- 
tially because cf the qualities of the computer's Operating System (OS). 

However, there is ere thing thrct the Commodore OS enr't do: make 
you" programs compatible with a computer made by another company. 
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Most o+ the time you won't even hove to think about jsing another com- 
pony's ta-rnpuier, because your Commodore 64 is so easy to use, But for 
the occasional jse' who warts to take aovantage of software that may 
not be available in Commodore 64 format we hcve created a Commo- 
dore CPlf/fi cartridge, 

CP/M® is not a "compute' dependent" ope-ating system, Instead it 
uses some of the memory space normally available for programming to 
run its own operating system. There are advantcges and disadvantages 
to this. The disadvantages are that the programs yoj write will hove to 
be shorter than the programs you can write using the Commodore 64's 
built-in operating system, In addition, you r.an NOT use the Commodore 
64's powerful screen editing capabilities. The advantages are that you 
can now use a large amount of software that has been specifically de- 
signed for CP/M ffi and the Z-SO microprocessor, and the programs that 
you write using the CP/M® operating system can be Transported, and run 
on any other computer 'hat has CP/M* and a Z-80 card. 

By the way, most computers thaT have a Z-80 microprocessor require 
that you go Inside the compute^ to actually install a Z-80 care!. With this 
imeThoc yoj nave to be very careful noT to disturb the delicate circuitry 
that runs the rest of the computer. The Commodore CP/AA® cartridge 
eliminates this hassle because our Z-80 cartridge jjluys info the back of 
your Commodore 64 quickly and easily, without any messy wires that 
can cause problems later. 



USING COMMODORE CP/M® 

The Commodore Z-80 cartridge ef s you run programs designed for a 
Z-80 microprocessor on your Commodore 64. The cartridge is provided 
with a ciskette containing the Commodore CP/M* operating system. 



RUNNING COMMODORE CP/M® 

To run CP/W,®: 

1) LOAD trie CP/M S program from your disk drive. 

2) Tyco R UN. 

3) Hit the BMtM k ey . 
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At rhis point the 64K bytes nf RAM in the Conn mod ore 64 or& accessi- 
ble by the built-in 65 '0 centred processor, OR 48K bytes of RAM are 
availab e far the 2-SO central pror-e^or. You can shift bock cine forth 
between these two processors, but you can NOT use them ai the same 
time Yi a s ngle program. Tiis is possible because of your Commodore 
6^'s Sophisticated liming mechanism. 

Below is the memory address trans atton thct is performed on the 
Z-80 cartridge. You should notice- that by adding 4096 bytes to the 
memory locations used in CP/M® $1000 (hex) you equal the memory 
addresses of the normal Commodore 64 opcraling system. The corre- 
spondence between Z-80 and 6510 memory addresses is as follows: 



Z-80 ADDRESSES 


6510 ADDRESSES 


DECIMAL 


HEX 


DECIMAL 


HEX 


0000-4095 


0000- 0FFF 


4096-8191 


1 003- IFF F 


4096-8191 


1000-1 FFF 


8192-12287 


2000-2FFF 


8192-12287 


20OC-2FFF 


12288-16363 


3 000- 3 FFF 


12288-16383 


300C-3 : FF 


16384-20479 


400D-4FFF 


6384-20479 


4000-4FFF 


20480-24575 


5000-5FFF 


20480-24575 


50O0-5FFF 


24576-28671 


6000-6FFF 


24576-28671 


60O0-6FFF 


28672-32767 


7000- 7FFF 


28672-32767 


700C-7FFF 


32768-36863 


8000- 8 FFF 


32768-36663 


Booo- srrr 


36864-40959 


9000- 9 FFF 


36864-40959 


yOOO-VFFF 


40960-45055 


AUOO-AFtf- 


40960-45055 


A000-AFFF 


45056-49151 


B0Q0-BFFF 


450 56-491 51 


B000-BF-F 


49152-53247 


caao-OFr 


49152-53247 


C00O-CFFF 


53248-57343 


D0O0-DFFF 


53248-57343 


D000-DFF = 


57344-61439 


EQOQ-EFFF 


57344 61439 


E000 EFFF 


61440 65535 


FOOD FFFF 


61440-65535 


F000-FFFF 


0000-4095 


0000-0FFF 
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To TURN ON the Z.-BO and TURN OFF ihe 6510 chip. Type in the follow- 
ing prog'arr: 

13 REM THIS PROGRAM IS TO EC USED WITH THE Z&B CflKD 
28 REM IT FIRST STORES 280 EflTH AT *10@0 

30 REM THEM IT TURNS OFF THE- 6510 IRQ'S HND ENABLES 

4@ REM THE SB@ CARD. THE ES0 CftftB MUST BE TURNSB 

OFF 

!5@ RE 1 "! TO REEHflBLE THE G510 SV8TEM. 

l@a ft£M STORE 2S© 3fiTfl 

1)0 REHE B 5En GET SIZE OF 2:3d CODE TO 3E MOVEE 

120 FUR 1=4-036 TO 409E+E-1 : REM MOI/E COIIE 

130 REHTJ R POKE I ■ ft 

1^0 NEXT I 

200 R£M RUN ES0 CODE 

£13 POKE 5SS33j1£7 ■ REM URN OF 631.E IRQ'3 

229 POKE 56032,00 ■ REM TURN OH 2Qfl CAftTJ 

230 POKE 5(5:333.. 129 ' REM TURN ON 6510 IRR'S WHEN 
Z80 do*: 

246 END 

lee© REM 286 '4BCHIHE LPNOURGE CQBE DRTfi SECTION 

1010 OTTR 18 : REM SIZE OF D-TFP TO BE PASSED 

1100 REM 280 TURN ON XBE 

1110 HRTF 00.00,60 ! 3EH OUR 288 CflSB REQUIRES 

TURN OH TIME =HT $0000 

1200 REM 260 TRSK IIFIT^ HERE 

1210 nflTfl 33, 02.245 : REM LB HI , UN «jCCfl"T3N ON 

SCREEN> 

1220 ORTR 52 ' REM I HO HL C INCREMENT THFT J3CRTION5 

1;™80 REM ZS0 SELF-TURN OFF UFITh HERE 

1318 3RTR 62,81 - REM LB FhH 

1323 DHTR I 50,93,2O£ ! REM LB CNN><fi -I/O LOCFTIOH 

1333 BR TO H0)ai3j0» : REM NOP 1 NOP 1 NOP 

1346 IiflTfl 135,-00.00 ; REM JMP S80000 



For mure details abuul Curtirngdore CP/A1® and the Z-80 microproces- 
sor loot for 1he ccrtridge and the Z-80 Reference Guice at /our local 
Commodore computer dealt; . 
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ABBREVIATIONS FOR 
BASIC KEYWORDS 



As a time-saver when typing in programs and commands,. Commo- 
dore fid BAStr nllnws The use r td abbreviate most keywords. The ab- 
breviation for PRINT is a question mark. The abbreviations for other 
words nre mods by tyoing the first nns or two lettprs rjf the word, fol- 
lowed by the SHIFTed next lettef of the word. If the abbreviations a r e 
used in a program line, the keyword will LIST in the full form, 



Com- 
mand 


Abbrevi- 
ation 


Looks like 
this an 
screen 


Cam- 

rriulicl 


Abbrevi- 
ation 


ABS 


A H:il3« B 


a[D 


tvrj 


e tTBIHl n 


AND 


A ESI n 


A0 


EXP 


E J.Hi!tii X 


ASC 


A EilIJi S 


A® 


FN 


MONE 


ATN 


A MINI T 


*D 


FOR 


F t-;l ji O 


CMR$ 


C jflfl H 


<= - 11 


F^r 


F |--;ili5 R 


CLOSE 


ciEEl o 


oC 


GET 


G K1IBI E 


CLR 


'•'■ ^^3 i 


cD 


GET# 


MONE 


CHD 


c HH M 


^S 


GOSUB 


gc ) HEIff 5 


CONT 


c ^Bl o 


cD 


GOTO 


G Bfl O 


COS 


NONE 


COS 


IF 


NONE 


DATA 


D EE1 A 


00 


INPUT 


MONF 


DEF 


D fdTijI E 


°Q 


INPUT* 


1 BBIH1 N 


DIM 


d ^BIBl i 


dQ 


INT 


NONE 



Looks like 
thh an 
screen 



« 
E ® 
FN 

f □ 

f y 

c H 

GET# 
Gog 

g n 
i= 

INPUT 

' 

INT 
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Com' 

mand 


Abbrevi- 
ation 


Looks like 
this on 
screen 


Com- 
mand 


Abbrevi- 
ation 


Looks like 

this on 
screen 


LEFT$ 


LE Ki:i: n - 


*Q 


RICH IS 


•: t--:H31 1 


«0 


LEN 


ISONE 


LEN 


RND 


r mini n 


R0 


LET 


L ^H r_ 


^a 


RUN 


R ^^3 U 


rQ 


LIST 


L EJffl I 


^a 


SAVE 


S EfflSl A 


s ® 


LOAD 


! Uliui G 


m 


SGN 


5 B!IB1 g 


sn 


LOS 


NONE 


LOG 


SIN 


s fiUBl i 


sQ 


MIDI 


■''■'■■ E2SJ ' 


«H 


SPC< 


s EE3 ' 


*□ 


NEW 


NONE 


NEW 


SQR 


s £2m q 


* 


NFKT 


N gJJJ E 


N B 


STATIS 


ST 


ST 


NOT 


n gBn o 


nH 


STEP 


stBBHI e 


STb 


ON 


NONE 


ON 


STOP 


S mi^J T 


3D 


OPEN 


o jjjjj p 


on 


STR$ 


ST f^QH R 


stQ 


OR 


NONE 


OR 


SYS 


S fciMJB Y 


*a 


PEEK 


pBBHI e 


^B 


TABC 


T CIJISl A 


tW 


POKC 


p EBE1 o 


p C 


TAN 


NONE 


TAN 


POS 


NONE 


POS 


THEN 


t MI'TjI i- 


'□ 


PRINT 


p 


? 


TIME 


T\ 


Tl 


PRINT* 


p ElffBl r 


P P 


TIM:$ 


m 


"1$ 


READ 


? ETTal e 


« B 


USR 


U FTCTa! 5 


U® 


REM 


WO ME 


REM 


VAL 


v EJUiJ a 


v@ 


RESTORE 


RE ffflffl S 


« H 


VERIFY 


V jSBfal E 


vQ 


RETURN 


RE I3TT5I T 


RcQj 


WAIT 


w ETB1 a 


w® 
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SCREEN DISPLAY CODES 



The folow : ncj chart lists sll of the characters auilt into rhe Commodore 
64 cha'acier sets. It shows which numbers should be POKEd in'o sceen 
memory (locations 1024-2023) to get a desired character. Also shown Is 
which ehcracTer corresponds to a number PEEKed from the screen, 

Two charaete- sets arc available, but only one set at a rime, This 
means that you cannot hove characters from one set on the screen at 
the some time you have characters from the other tot displayed. The 
sets are switched by holding down the f f Hjj) and Rl keys simul- 
taneously. 

From BASIC, POKE 53272,21 will switch to jpper case mode and 
POKE 53272,23 switches to lower case. 

Any number on the chart may also be displayed in REVERSE. The 
reverse character code may b9 obtained by adding 128 to the values 
shown. 

If you want to display o solid circle at location 1504, POKE the code 
for the circle [81) into location 1504; POKE 1504,61. 

There is o corresponding memory location to control the color of each 
cnaracter displayed or the screen (locations 55296-56295). To change 
the color of the circle to yellow (color code 7) you would POKE the corre- 
sponding memory location (55776) with the character color: POKE 
55776,7 

Refer to Appendix D for the complete screer and color memory maps, 
along with rnlnr nodes. 



NOTE: The following PQKEs display ttie same symbol in set 1 and 2: 1, 27—64, 
91-93, 96-104. 106-121, 123-127. 



SCREEN CODES 



SET 1 


SET 2 


POKE 


SET 1 


SETS 


POKE 


SET 1 


SET 2 


POKE 


@ 







c 


C 


3 


F 


f 


6 


A 


8 


1 


D 


d 


4 


G 


9 


7 


B 


b 


2 


E 


e 


5 


H 


h 


a 
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SET 1 SET 2 


POKE 


SET 1 SET 2 POKE 


SET1 


SET 2 


POKE 


1 


i 


9 


% 


3? 


a 


A 


65 


J 


. 


10 


& 


36 


m 


B 


66 


K 


k 


11 


' 


39 


a 


c 


67 


L 


1 


12 


( 


40 


5 


D 


63 


M m 


13 


] 


41 


H 


E 


69 


N 


T 


14 


- 


42 


□ 


F 


70 


O 


T 


15 


+ 


43 


D 


G 


n 


P 


P 


1S 


i 


44 


a 


H 


72 


Q 


q 


17 


- 


45 


Q 


I 


73 


P 


r 


10 




46 


a 


J 


74 


S 


5 


19 


I 


47 


□ 


K 


75 


T 


t 


2D 





46 


□ 


L 


76 


u 


U 


21 


1 


49 


s 


M 


77 


V 


V 


22 


2 


50 





N 


78 


w 


w 


23 


3 


51 


□ 





79 


X 


X 


£4 


4 


52 


□ 


3 


ee 


Y 


y 


25 


5 


53 


♦ 


Q 


81 


£ 


z 


26 


6 


54 


□ 


R 


82 


[ 




27 


7 


55 


H 


S 


83 


£ 




28 


8 


56 


D 


T 


84 


] 




2S 


9 


57 


a 


L 


85 


' 




30 


: 


58 


X 


V 


86 


<— 




31 

32 
33 


< 


59 
60 

61 


a 


w 

X 

Y 


87 


[ SPACE 


88 


! 


69 


It 




34 


> 


62 


ifl 


Z 


90 


# 




35 


? 


63 


ffl 




91 


S 




36 


a 


64 


D 




92 
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SET1 


SET Z 


POKE 


8ET1 


SETS 


POKE 


SET 1 


BETS F 


m 




93 


B 


m 


105 


c 




m 


^ 


94 


a 




106 


LI 




a 


s 


9G 


DB 




107 


n 




I 9 


96 


[■ 




106 


H 




E 




97 


G 




1Q» 


U 




H 




98 


ffl 




110 


a 





^ 




99 


U 




111 


y 




J 




100 


r? 




112 


a 




□ 




101 


B 




113 


H 




m 




102 


a 




114 


H 




n 




103 


BD 




115 


H 




^ 




104 


O 




116 







POKE 
117 

116 
119 
120 
121 
122 
123 
12A 
125 
126 
127 



Codes from 128-255 are reversed Images ol codes 0-127. 
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ASCII AND CHR$ CODES 



This appendix shows you what characters will appear if you PRINT 
CHR$(X>, for all possible values of X. It will also show the values ob- 
tained by typing PRINT ASC< "x"), where x fs any character you can type. 
This is useful In evaluating the character received in a GET s-aternent, 
converting upper/lower case, and printing character based commands 
(like switch to upper/lower case) that could not be enclosed in quotes. 



PRINTS CHR« 


PRINTS 


CUR* 


PRINTS 


CHRj 


PRINTS 


CHR* 





■::.-■. 


17 


" 


34 


3 


51 


1 


m 


19 


# 


35 


4 


52 


2 


' :;.;':. 


19 


$ 


36 


5 


53 


3 


19 


20 


% 


37 


6 


54 


4 




21 


& 


33 


7 


55 


J^^M 5 




22 


■ 


39 


8 


56 


6 




23 


( 


40 


9 


57 


7 




24 


) 


41 


. 


58 


:iK».BL[5g^[3fc 




25 


* 


42 


i 


59 


ENABLES B B3fi 




26 


+ 


43 


<Z 


60 


10 




27 


3 


44 


= 


61 


11 


JQ 


28 


- 


45 


Z> 


62 


12 


B 


29 


• 


46 


7 


63 


j^^^J 


13 




30 
31 
32 


/ 



1 


47 

46 
49 


@ 

A 
B 


64 
65 
66 


1 SWUCH TO 

1 LOWER CASE 


14 




1£ 




16 


! 


33 


2 


50 


C 


67 



APPENDS 
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PAINTS 


CHFW 


PRINTS 


CUM 


PAINTS CHRS 


PfllMTS 


CHRS 


D 


68 


I*] 


97 


126 


Rrey 3 


155 


E 


69 


m 


98 


a 127 


g^ 


156 


F 


70 


B 


SS 


12S 


',!-•:.' 


157 


G 


71 


a 


100 


Orange 129 


jpm 


158 


H 


72 


a 


101 


130 


B 


159 


1 


73 


B 


102 


131 


E33 


160 


J 


74 


□ 


103 


132 


E 


161 


K 


75 


LD 


104 


f1 133 


B 


162 


L 


76 


Q 


105 


f3 134 


□ 


163 


M 


77 


C3 


106 


fS 135 


LJ 


164 


N 


7B 





107 


f7 136 


□ 


165 





79 


D 


108 


f2 137 


S 


166 


P 


80 


S 


109 


M 138 


□ 


197 


Q 


81 





110 


16 139 


s 


168 


R 


82 


r 


111 


18 140 


B 


169 


s 


83 


□ 


112 


V i:^S"| 41 


□ 


170 


T 

u 


64 
85 


□ 


113 
114 


[EilaEai 


ffl 


171 
172 


143 


V 


86 


a 


T5 


UJ| 144 


Q 


173 


w 


67 


□ 


16 


ffi|j 145 


FH 


174 


X 


68 


ra 


17 


jsi us 


3 


175 


Y 


89 


Kl ■ 


18 


i-i;;r; ' 4 ' 


3 


176 


1 


SO 


D • 


19 


H '« 


R 


177 


[ 


91 


E 1 


20 


Brown 1 49 


a 


178 


t 


92 


m 1 


21 


Lt. Rud 150 


a] 


179 


] 


93 


a 1 


22 


Grey 1 1 51 


D 


180 


t 


94 


ffl 1 


23 


Grey 2 152 


C 


181 


t- 


95 


E i 


24 


Li. Green 1 53 


a 


182 


B 


96 


DD 1 


25 


Lt, Blue 154 


□ 


183 


APPENDIX C 













[ PRINTS 


CHRS 


PRINTS 


CHRS 


PAINTS 


CHR* 


PRINTS 


CHfiS 


3 


184 
185 




185 
187 




188 

189 


El 
» 


190 
1S1 



COOES 


192-223 


SAME AS 


96-127 


CODES 


224-254 


SAME AS 


160-190 


CODE 


255 


SAME AS 


126 
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SCREEN AND COLOR MEMORY MAPS 



The following charts list which memory locations control placing char- 
acters on the screen, and the locations used to change individual char- 
acter colors, as well as showing character color codes 

SCREEN MEMORY MAP 



COLUMN 

20 



lQZf- 

1061 

HOT 

I Ml 

\m 

1H( 
1JSJ 

1301 
1-H 
123* 

Kji 
1464 
I5D4 
1544 
l:»J 
1624 
1664 

™ 

175' 

182* 
1» 
I9TJJ 
194' 
I* 



.Jl..: 



_~r-i~in — —i — 

_ --rr- 

u_ 



_ 23 
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The actual values to POKE into a cclor memory' location to change a 
character's color are: 






BLACK 


1 


WHITE 


2 


RED 


3 


CYAN 


A 


PURPLE 


5 


GREEN 


6 


BLUE 


7 


YELLOW 



8 


ORANGE 


9 


BROWN 


a 


Liaht RED 


11 


GRA V 1 


12 


GRAY 2 


13 


Light GREEN 


M 


Light BLUE 


15 


GRA V 3 



For example, to change the color of a character located at tre upper 

left-hand corner of "he screen to red, type; POKE 55296,2, 

COLOR MEMORY MAP 



COLUMN 
20 



vl 



=5536 
E537S 
55416 
55-155 
554 96 
55! 38 
55575 
55615 
55455 
bbtUIJ 
55?3S 
55773 
Bll> 
5S155 
55S9J 

55135 

5S97i 

58815 
55(155 
551)95 
56:35 
56173 
56: 15 
56255 



55335 






i:i o 



i 

56J95 
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MUSIC NOTE VALUES 



This appendix contaii; a complete list of Note#, actual note, and rh& 
values to be POKEd into the HI FREQ and LOW FREQ registers of the 
sound chip to produce llie i ridiculed r ule. 



MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECIMAL 


HI 


LOW 





C-0 


268 




12 


1 


C#-0 


284 




28 


2 


D-G 


301 




45 


3 


D#-0 


318 




62 


4 


E-0 


337 




81 


5 


F-0 


358 




102 


6 


F#-0 


379 




123 


7 


G-0 


40 ; 




145 


8 


G#-C 


425 




169 


9 


A-0 


451 




195 


10 


A#-0 


477 




221 


n 


B-0 


506 




250 


16 


C-l 


536 


2 


24 


17 


C#-l 


568 


2 


56 


18 


D-l 


602 


2 


90 


19 


D#-l 


637 


1 


125 


20 


E-l 


675 


7 


163 


21 


F-l 


716 


2 


204 


22 


F#-l 


758 


2 


246 


23 


G-l 


803 


3 


35 


24 


G#-l 


851 


3 


83 


25 


A-1 


902 


2 


134 


26 


A#-l 


955 


3 


187 


27 


B 1 


1012 


a 


244 


32 


C-2 


1072 


4 


48 
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MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECIMAL 


HI 


LOW 


33 


C#-2 


1136 


4 


1 12 


34 


D-2 


1204 


4 


180 


35 


D#-2 


1275 


4 


25 i 


36 


E-2 


1351 


5 


71 


37 


F-2 


14.32 


K 


152 


38 


F#-2 


1517 


5 


237 


,19 


G-2 


1607 


6 


71 


40 


G#-2 


1703 


6 


167 


41 


A- 2 


1804 


7 


12 


42 


A#-2 


1911 


7 


119 


43 


B-2 


2025 


7 


233 


48 


C-3 


2145 


9 


97 


49 


C#-3 


2273 


8 


225 


50 


D-3 


2408 


9 


104 


51 


D#-3 


2551 


9 


247 


52 


E-3 


2703 


10 


143 


53 


F-3 


2864 


11 


4S 


54 


F#-3 


3C34 


11 


218 


55 


G-3 


3215 


12 


143 


56 


G#-3 


3406 


13 


78 


57 


A- 3 


3<SC8 


14 


24 


58 


A#-3 


3823 


14 


239 


59 


B-3 


4050 


15 


210 


64 


C-4 


429 3 


16 


195 


65 


C#-4 


4547 


17 


195 


66 


n-4 


4817 


18 


209 


67 


D#-4 


5JG3 


19 


239 


68 


E-4 


54(jy 


21 


31 


69 


F-4 


5728 


22 


96 


70 


F#-4 


6069 


23 


181 


71 


G-4 


6430 


25 


30 


72 


G4-4 


6812 


26 


156 


73 


A-4 


7217 


28 


49 


74 


A#-4 


7647 


29 


223 


75 


B-4 


0101 


31 


165 


so 


C-5 


8683 


33 


135 


31 


C#-5 


9094 


35 


134 
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MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECIMAL 


HI 


LOW 


82 


D-S 


9634 


37 


162 


83 


D#-5 


10207 


39 


223 


64 


E-5 


10814 


42 


62 


85 


F-5 


1 1457 


44 


193 


86 


F#-S 


12139 


47 


107 


87 


G-5 


12860 


50 


60 


88 


C#-5 


13625 


53 


57 


89 


A-5 


144-35 


56 


99 


90 


A# 5 


15294 


59 


190 


91 


B-5 


1A2G3 


63 


75 


96 


C-6 


17167 


67 


15 


97 


C#-6 


18188 


71 


12 


98 


D-6 


19269 


75 


69 


99 


D#-6 


20415 


79 


191 


100 


E-6 


21629 


84 


125 


101 


F-6 


22915 


89 


131 


102 


F#-6 


24278 


94 


214 


103 


G-6 


25721 


100 


121 


104 


G#-6 


27251 


106 


115 


105 


A 6 


28871 


112 


199 


106 


A#-6 


.10588 


119 


124 


107 


B-6 


32407 


126 


151 


112 


C-7 


34334 


134 


30 


113 


C#-7 


36376 


142 


24 


114 


D-7 


38539 


150 


139 


115 


D#-7 


10830 


159 


126 


116 


C-7 


43258 


168 


250 


117 


F-7 


45830 


179 


6 


118 


F# 7 


48556 


189 


172 


1 19 


G-7 


51443 


200 


243 


120 


G#-7 


54502 


212 


230 


121 


A-7 


57743 


225 


143 


122 


A#-7 


61176 


238 


248 


123 


B-7 


64814 


253 


46 



366 



APPENDIX E 



FILTER SETTINGS 



location 


Contents 


54293 


Low cutoff frequency (0-7) 


5-1294 


High cutoff frequency (0 — 255) 


54295 


Resonance (bits 4-7) 




Filter voice 3 (bit 1) 




Filter voice 1 (bit 1J 




Filter voice 1 (bit 0) 


64296 


Hign priR=; (hit 6) 




Bandpass (b t 5; 




Low poss (hit 4) 




Volume (bits 0-3) 
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Creative Computing "Getting Acquainted With Yolt VIC 20", 

T. Hartnell 
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"Mostly 3ASIC: Applications for Your PET", 
Howard Berenbon 

"PET Interfacing", James M, Downey ond Ste- 
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Firik*l, P, Higg in bottom, N. Harris, and AA. 
Tamczyk 
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and Homes", j. Victor Nagigian, and William 
S. Hodges 

"The Computer Tutor: Learning Activities for 
Homes and Schools", Gary W. Orwig,. Univer- 
sity of Central Florida, and William S Hodges 

"Hands-On BASIC With « PET", Herbet D. 
Peckman 

"Home and Office Use of VisiCalc", D. 
Castew'tz., and L. Chljauki 

"PET/CBAA Personal Computer Guide", Carrol 
S. Donahue 

"PET Fun and Gnmes", R- Jeffries and G. 

Fisher 

"PET and the IEEE", A. Osborne and C. 

Donahue 

"Some Common BASIC Programs for the PET", 
L. Poole, M. Borchers, and C. Donahue 

"Osborne CP/AA User Guide", Thorn Hogan 

"CBM Professional Computer Guide" 

"The PET Persons I Guide" 

"The 30B6 Bouk", Russel Rettor and George 
Alexy 

"Beginmr.g Self-Teaching Computer Lessors" 
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Prentice-Hal! 

Reston Publishing Co. 



"The PET Perianal Computer For beginners'', 
5, Dunn and V. Morgan 

"PET and trie IEEE 438 Bus {GPIBj", Eugene 
Fisher and C. W. Jensan 

J 'PET BASIC — Training Your PtT Computer", 
Rcmon Zamcrc, Win. F, Carrie, and B. 
Allbrecht 

"PET Games and Recreation", M, Ogelsby, L. 
Lindscy, and D. Kunkin 

"PET BASIC", Richcrd huskell 
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Tel ma $ Courseware "BASIC and the Personal Computet', T, A, 
Ratings Dwypr, end M. Critchfield 
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vices Programming" 

"Understanding Your VIC", David Sehultz 

Commodore Magazines provide you with the most up-to-date info- 
mation for you' Commodore 64, Two of the most popular publications 
lhat you should seriously consider subscribing Ic are: 

COMMODORE — -The Microcomputer Magazine is publ'shec bl-month y 
and is available by subscription ($15.00 per year, U.S., and $25.00 per 
yeor, worldwide), 

POWER/PLAY — The Hntre Computer Magazine is published quarterly 
and is available by subscription [$10,00 per year, U.S., and $15.00 per 

year warldwide). 
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VIC CHIP REGISTER MAP 



5324B 


t$D 


000) 


Start 


ng [B 


ase} Address 










Register 


#■ 

Hex 


DB7 

SDX7 


db« 


DB5 


DBd 


DSJ 


DB2 


DB1 


DBO 


_ ' 




1 

2 

3 
4 

5 


7 
ft 

10 
11 

12 
13 

"4 

15 

It 

17 
18 
19 

20 




2 
3 

i 
5 

7 
B 

B 
C 
D 
E 

1 

10 

11 
12 
13 
14 












soxo 


SPRITE 3 X 

Component 


SO/7 










SOYO 


SPRITE Y 
Cornponert 


51X7 










51 XC 


3PRITE 1 X 


S1Y7 












S1Y0 


SPRITE 1 Y 


52X7 












52X0 


SPNIlt I X 


S2Y7 












52 YO 


SPRTE 2 Y 


53X7 














S3xa 


5PRITE 3 X 


53Y7 















S3YC 


SPRITE 3 V 


54X7 










S4X0 


SPRITE .1 X 


5JY7 














SlYO 


SPRITE 4 V 


55X7 














s;xo 


SPRITE 5 X 


SSY7 














SSYO 


SPRITE 3 Y 


S6X7 














S4X0 


SPRITE 6 X 


S6Y7 














S4Y0 


3FRITE 6 Y 


37X7 














S7X0 


SPRITE 7 X 
Componenr 


S7Y7 














S7Y0 


SPRne 7 y 

Component 


Sj'XS 


S6XB 


Six a 


baxa 


WXS 


siixa 


51X8 


50X8 


MSB of X 

Y SCROLL 
MOPE 


RC8 


ECW, 


BMW 


BLNK 


REEL 


YSCL2 


YSCL1 
RC1 


YSCLO 

RCO 


ec7 


RC6 


PCS 


RC4 


RC3 


RC2 


RASTER 


.FX7 












LPXO 


LIGHT P = N X 


PY7 
1 












LPYO 


UOHT PEN Y 
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Register 
Dec 


# 

He* |0E7 ' 056 


DBS 


054 


DB3 


D62 


DBT 


DBO 




21 


15 SE7 












SEO 


SPRITE 




















ENAB'.E 


22 
33 


16 
17 
















(ONi'OhH 


N.r. n,c 


RST 


m™ 


CSEL 


XSCL2 


XSCL1 


XSC.O 


X SCROLL 
MODE 


SEXV7 












SEXVO 


SPBITE 




















EXPAND V 


24 


16 


VS13 VS12 


VS11 


VSlO 


can 


CB19 


CB11 


N.C. 


SCKttN and 


n 


19 


















Character 
Viemcry Base 
Address 


IRQ 


N.C. 


N.C. 


tJ.C. 


LPIR3 


ISSC 


ISEC 


RIP.Q 


Interrupt 


26 


1A 


















Request's: 


N.C. 


N.C. 


N.C. 


N.C. 


MLPl 


MISSC 


misbc 


MRISQ 


Int&rrjpt 






















Req je^l 


27 


IB 


















MASKS 


ESP 7 














B5P0 


Backcro-unc- 






















5 3 rile 


l\i 


IC 


















PRIORITY 


SCM7 














5CiW 


ViULTICOLCR 






















SPRITE 


29 


ID 


















icLtLT 


SEXX7 














sfxxo 


=;?ritf 


30 


IE 


















EXPAND X 


£SC7 














ssco 


Sprite Sprite 


31 


ir 


















CCLJEON 


SBC7 














SBCO 


Sprite- 






















Background 






















CCLJSION 



3»J APPENDIX Q, 



Dec 


He* 


Color 


32 


20 


BOEDER COLOR 


33 


21 


BACKGROUND 
COLOR 


34 


a 


BACKGROUND 
LiOlCR 1 


35 


S3 


R^CKGFIOUND 
0O.0R 2 


36 


24 


EACKGROUND 
COLOR 3 


37 


£5 


SPRITE 
MULTICOLOR 3 


38 


26 


SPRITE 

MULTICOLOR 1 



Reg s 

Dec 


Hex 


Color 


39 


27 


SPHITE [i COLOF, 


« 


20 


SPRITE ■ COLOR 


41 


;s 


SPRITF 2 COLOR 


42 


2A 


3f HITS 3 TOLOF, 


43 


2B 


SPRITE 4 COLOF 


44 
45 


EC 


SPRITE t COLOR 


2D 


SPRITE a OCLCR 


43 


2E 


SFRJTE7COLCR 



COLOR CODES 







' 


Dec 


Hex 


Color 


€ 

1 





BLACK 

WHITE 


2 


z 


=IED 


3 


i 


ZYAN 


4 


4 


J JHPLt 


5 


5 


n=IFFN 


3 


6 


BLUE 


7 


7 


YELLOW 



Uec 


Hex 


Color 


a 


a 


ORANGE 


9 


i 


BROWN 


ID 


a 


L" -1ED 


11 


a 


GRAY 1 


15 


C 


GRAY ? 


13 


D 


LT GREEN 


H 


E 


LT BLUE 


IE 


F 


GRAY 3 



LEGEND: 

ONLY COLORS 0-7 MA/ BE USED IN WIULTISO_OR 3HAFACTEP; MODE 



AFTfcNDlX G 



ava 
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DERIVING MATHEMATICAL FUNCTIONS 



Functions that are not Intrinsic to Commodore 64 BASIC may be calcu- 
lated as follows; 



FUNCTION 


BASIC EQUIVALENT 


SECANT 


5EC(X)=l/COS;X) 


CQStUANT 


C5CCX>=l/SN(X) 


COTANGFNT 


coTm=mAN.:x) 


INVERSE SINE 


aksim;»=atn[x/sqr;-x"x+i:.) 


INVERSE COSINE 


APCrOS(X)=-ATNtX/SQR 




{-x*x +!)) +sr/s 


INVERSE SECANT 


ARCSEC<X)=ATN<X/SQR(X*X- 1)) 


INVERSE COSECANT 


ABCCSCPQ- ,\TN(X,'SQRCX* X - 1 i) 




+ <SGN(X)- 1*17/2 


INVERSE COTANCENT 


ARCOT(XVh-ATN(X>-T,': 


1 YPERBOJC SINE 


SINHfX)=(CXP[X) EXP[ X)j/2 


1 YPCRBOJC COSINE 


COSH(X) = (EXr(X)+EXP(-XlV2 


l-YPERBOLIC ""ANGENT 


TANH(X;=EXP( X]/(EXP(x) I EXP 




(-X))*2 + l 


HYPERBOLIC SECANT 


5KH(X)= 2/!EXF(X)+EXP;-X)) 


hYPERBQJC C05ECANT 


CSCH(X)=2/(£XF(X)-EXP(-Xfl 


hYHEKBULIC COIANCitNI 


COTHP0= EJCPt- XlTbXPCXi 




-tXH— XJ)*2 fr l 


INVERSE HYPERHOUC SINE 


AHCilNH[X)=LLJGlX + St;R(X*X-l]) 


INVERSE HYPFRBOIIC COSINE 


AKCCOSH<X}=LOG[X- SOKIX'X- lit 


INVERSE HYPERBOLIC TANGENT 


APCTANH(X)=IOfi(0 + X:/(l-X}i/? 


INVERSE HYPERBOLIC SECANT 


APCSECH(X)=LOC-<!SQR 




(-x*k+o+i;x> 


INVERSE HYPERBOLIC COSECANT 


ARCCSCH(X)=LOG((SGN|X)*SQB 




(X*X-l/*i 


INVERSE HYPERBOLIC COTAN- 


ARCCOTH(X) - LOCi[X+ l)/;x - l )J/2 


GENT 
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PINOUTS FOR INPUT/OUTPUT DEVICES 



fhis appendix is designed to show you what connections may be 
made tc the Commoeore 64. 



1) Game I/O 

2) Cartridge Slct 
3> Audio/Video 



Control Port 1 



Pin 

1 


Typ* 

JOVAO 


Not. 


1 


JCYA1 




3 


JQYA2 




4 


JOYA3 




5 


POT AY 




6 


SUTTON aJ LP 




7 


+5V 


MAX. SO-nA 


8 


ONE 




9 


POT AX 





4) 


Sericl I/O (Disk/P-inter) 




5) 


Modulator 


Output 




6) 


Cassette 






7) 


Jser Port 








( . 


2 3 4 


5 




° 


O O 


o 




\ ° 


o o 


° i 




V_i 


7 8 


' J 



Control Port 1 



Pin 

1 


Fyp* 

JOVBO 


Not. 


1 


JOYB1 




3 


JOVB2 




A 


JQYB3 




S 


POT BY 




& 


BJTTON E 




7 


+ 5V 


MAX. SO-nA 


S 


StJC 




9 


pot 6/ 
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Cartridge Expansion Slot 



Pin 


Type 


1 


GND 


2 


4-5V 


3 
4 


4-5V 


5 


ff/W 


6 


Dot Ctawk 


7 


I/O 1 


e 
9 


SAME 


EXRQM 


10 


I/O 2 


n 


ROML 



Pin 


Type 


A 


GNJ 


B 


ROMH 


L 


RE5FT 


D 


MMI 


E 


S 0? 


F 


A15 


H 


AU 


J 


A13 


C 


Aia 


I 


All 


M 


A10 



B21 20 19H 17 IS 15 11 13 IE 11 tO 8 8 7 B ! I 3 2 1 



Audio/Video 



Seriol I/O 



Pin 


Type 


12 


BA 


13 


DMA 


14 


D7 


15 


Dfi 


16 


C5 


17 


C4 


IB 


C3 


19 


C2 


20 


Cl 


21 


CO 


22 


GNU 



pin 


T yp«_ 


N 


AQ 


p 


A3 


R 


A7 


S 


A6 


T 


AS 


u 


A4 


V 


A3 


w 


A2 


X 


Al 


Y 


A3 


z 


GND 



Pin 


Fyptt 


Nan 




LUMINANCE 




2 


3ND 




i 


AUDIO OUT 




4 


VIDEO OUT 




5 


AUDIO IN 





Pin 


Type 


1 


SERIAL SRQIN 


2 


GND 


3 


SERIAL ATN IN.'OUT 


4 


SERIAL CLK IN/OUT 


^ 
* 


SERIAL DATA IN, r OUT 
RESET 
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Cassette 



Pin 


Type 


A-l 


GND 


B-2 


+ 5V 


C-3 


CASSETTE MOTOR 


D-4 


CASSETTE READ 


E-5 


CA55ETTE WRITE 


F-G 


CASSfcTTfc SENSE 



1 Z 3 * J 6 



A B C D E F 



User I/O 



Pill 


Type 


Note 


1 


GND 




? 


+5V 


A\AX 100 mA 


3 


RESET 




j 


crai 




S 


SPl 




6 


CNT2 




7 


5P2 




8 


PC2 




9 


SEE. ATN JN 




10 


9 VAC 


MAX. IOC tA 


11 


9 VAC 


MAX. IOC -nA 


12 


CKD 





Pin 

A 


lyp* 

9ND 


Note 




B 


F.AG2 




C 


PBQ 




t> 


PB1 




E 


PB2 




F 


PB3 




H 


P34 




J 


P35 




IC 


P36 




L 


P37 




w 


RA2 




N 


GND 





2 3 d S 6 7 * S 10 11 12 



ABCDEFHJ KLMN 
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CONVERTING STANDARD 
BASIC PROGRAMS TO 
COMMODORE 64 BASIC 



IF you have, programs written in a BASIC other tnnn CnmmnHnre 
BASIC, sorre minor adjustments may be necessary before running them 

on the Corr modore-64, We've included some hints ro make rhe conver- 
sion easier. 

String Dimensions 

Delete all statements that are used to declare the length of strings, A 
statement such gs D\h\ A$(I,J], which dimensions a string array for J 
elements of lengtn I, should be converted to the Commodore BASIC 
statement DIM A$(J). 

Some HASICs use a romma or 01 oimrjersnnd for string concatenation. 
Each of these must be changed to a plus sign, which is the Commodore 
BASIC operator for string concatenation. 

In Commodore 64 BASIC, the MID$, RIGHT$, and LEFT J functicrs arc 
used to take substrings of strings. Forms such as ASCI) to access the Irh 
character in A$, o- A$(I..J) to "okc a substring of A$ from position I to J, 
must be changed as fo lows: 

Other BASIC Commodore 64 BASIC 

A${l) = X$ A$ = LEFT$(A$,I-1}-XJ+AAID$(A$,I i 1) 

A$(I,J) = X$ A$ = LEFT$(A$,1— 1)+X$+MID$CA$,J+!) 

Multiple Assignments 

To set B and C equal to zero, some BASICs allow statements cf the 
form; 

10 LET B=C=0 
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Commodore 64 BASIC would interpret the secord equal sign as a 
logical ope r ator and set B = — 1 if C — fl. Instead, rnnvprt this state- 
ment tO;' 

10 C = : B=0 

Multiple Statements 

Some BASICS use a oackslash (\ 3 to separate multiple statements on 
a line. With Commodore 64 BASIC, separate all 5tatc-ncnts by a colon 
CO- 
MAT Functions 

Programs using the MAT functions avallaole on some BASICs must be 
rewritten using FOR. . .NEXT loops to execute properly. 
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ERROR MESSAGES 



This appendix contains a complete lift of the error messages gener- 
ated by the Commodore-64, ^/ith a description of causes. 

BAD DATA Siring data was received from an open file, but the pro- 
gram was expecting numeric data. 

BAD SUBSCRIPT The program was trying + o refcence on clement of 
an array whose number is outside of rhe range speciflea in the DIM 

state merit. 

BREAK Program execution wes stopped because you hit the M J key- 

CAN'T CONTINUE The CONT command w II not work, either because 

the program was never RUN, there has beer an error, or a lino has 

beer edi*ed. 

DEVICE NOT PRESENT The required I/O device was net available far 

an OPEN, CLOSE, CMD, PRINT/. INPUT*, or GET*. 

DIVISION BY ZERO Division by zero is a mathematical oddity and rot 

ulTuwed. 

EXTRA IGNORED loo many items of data were typ&d in response to 

an INPUT 5-atemenr. Only the first few items were accepted. 

FILE NOT FOUND If you werp looking fnr n file nn tapp, and EN3-CF- 

TAPE marker was fcund. If you were looking on disk, no file with that 

name exists. 

FILE NOT OPEN The flic specified r, a CLOSE, CMD, PRINT#, INPU7#, 

or GET#, must first be QFENed. 

FILE OPEN An attempt was made to open a file using the number of 

an already open file. 

FORMULA TOO COMPLEX The string expression being evaluated 

shouid be split into at least two parts for *he system to work with, or a 

Formula has too many parentheses. 

ILLEGAL DIRECT The- INPUT statemen" enn only be used within r. pro- 

g'am, and not in direct mode. 

ILLEGAL QUANTITY A numoer used as the nrgument of a function sr 

statement is out of the allowable range. 
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LOAD There is a problem with The program on rape. 
NEXT WITHOUT FOR This is caused by either ncorrectly nesting loops 
Of having u vuiuble name in a NEXT statement that doesn't correspond 
with one in a FOR statement. 

NOT INPUT FILE An attempt was made fo INPUT or GET data from a 
file which was specified to be for output only. 

NOT OUTPUT FILE An attempt was made to PRINT data to a file which 
was specified as input only. 

OUT OF DATA A READ statement was executed out thera is no data 
left unREAD in a DATA statement. 

OUT OF MEMORY There is no mere RA/iA available for program or 
variables. This may also occu' when too rrany F05 loops nave been 
nested, or when the^e are too many GOSUBs in effect. 
OVERFLOW The result cf o computation is larger than the largest 
number allowed, which is 1.701 41 884E I 38. 

REDIM'D ARRAY An crray may only be Dimensioned once. If an array 
variable is used before lhat array is DIM'd, an automatic DIM operation 
is performed on that array setting the number of elements to ten, and 
any subsequsril DIMi will cause 1his error. 

REDO FROM START Character dato was typed in do'ing an INPUT 
statement when numeric da-a was expected. Just re-type tie entry so 
that it is correct, and Ihe program will continue by itself. 
RETURN WITHOUT GOSUB A RETURN statement was encountered, 
and no GOSUB rnmmnnd has been issued. 

STRING TOO LONG A string con contain up to 255 characters, 
?STNTAX ERROR A statement is unrecognizable by the Commodore 
64. A missing or extra parenthesis, misspelled keywords, etc. 
TYPE MISMATCH This prror orrurs when a number Is used : r place of a 
string, or vice-ver;a. 

LJWDEFD FUNCTION A user defined function was referenced, but It 
has never been defined using the DEF FN statement. 
UNDEFD STATEMENT An attempt was made to GOTO or GOSUB or 
3L.N a line rurnbef that doesn't exist. 

VERIFY The program on tope or disk does not match the program cur- 
rently in memory. 
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6510 MICROPROCESSOR CHIP 
SPECIFICATIONS 

DESCRIPTION 

The 6510 is a law-ccst microcomputer system capable of solving a 

broad range of small-systems and peripheral-control problems at 
m'rimiim rosl to the user. 

An 8-bit Bi-Direetional I/O Port Is located on-chip wilh the Oulput Reg- 
ister at Address 0000 and the Datn-Dirertinn Register nt Address 0001. 
The I/O Port is bit-by- bit program -noble. 

The Tlree-State sixteen-bit Adcress Due allows Direct Memory Access- 
ing (DMA) and multiprocessor systems scaring a common memory. 

The internal processor architecture s identical to the MOS Technology 
6502 to provide software compatibility. 

FEATURES OF THE 6510 . . . 

Eight- Bit Bi-Direeticral I/O Port 

Single +5-volt supply 

N-chainel, silicon gate, depleticr lood technology 

Eight-bit parallel processing 

56 Instructions 

Decimal and binary arithmetic 

Thirteen addressing mooes 

True indexing capability 

Programmable stack pointer 

Variable lericjli itauk 

Interrupt capability 

Eight-Bit Bi- Directional Data Bus 

Addressable memory -ange ot up to 6sK bytes 

D rect memory access capability 

Bus compatible with M6300 

Pipeline ari.iitecTure 

1-MHz and 2-MHz ope r ation 

Uie wild any lyp« ur speed memory 
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PIN CONFIGURATION 
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6510 CHARACTERISTICS 

MAXIMUM RATINGS 



RATING 


SYMBOL 


VALUE 


UNIT 


SUPPLY VOLTAGE 


V cc 


-0.3 to +7.0 


v DC 


INPUT VOLTAGE 


Vin 


-0.3 to +7.0 


V c 


OPERATING TEMPERATURE 


T A to +70 


°c 


STORAGE TEMPERATURE 


T STG -55 ro + 150 


°c. 



MOTE: This cevice contains inout protection againr damags cue to high static volt- 
ages or electric f elds; however, precauions should be taken to avoid application ot 
^oltoges higher tian the maximum rating. 



ELECTRICAL CHARACTERISTICS 

(VCC = S.O V ±5%, VSS = 0, T A - 0° Io +70°Q 



CHARACTERISTIC 


SYM- 
BOL 


MIN. 


TYP. 


MAX. 


UNIT 


Input High Voltage 

*l. tf>S(m> 
Irifjul High Vpltuye 
PES, Pc-P, T^Q, Data 


V,H 


V M - 0.2 
v'ss + 2.0 


— 


V cc + 1.0V 




Input Luw VtJiuge 
RES, P f -P, IRQ, Data 


V|L 


V» - 0.3 


— 


Vga +- J. 2 
Vbs + D.fl 


v DC 
Vnc 


Input Leakage C->rrent 

(V ir - 0to 5-25V, V'cc - 5.25V) 
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4>-, 0aln> 
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1 00 
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~hree Stcre [Off Stci-e) Input Current 
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Output High Voltage 
(low = -IQOpAoo, V cc = 4.75V) 
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Vnr 
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CHARACTERISTIC 


SYM- 
BOL 


MIN. 


TYP. 


MAX. 
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[l 0L = 1.6mA uc , V cc = 4.75V) 
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CLOCK TIMING 
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AC CHARACTERISTICS 

ELECTRICAL CHARACTERISTICS (V cc = 5 V ±5%, V ss = V, T„ = 0°-70°C) 

CLOCK TIMING 1MHz TIMING 2 MHz TIMING 



CHARACTERISTIC 


SYMBOL 


MIN. 


TYP. 


MAX. 


MIN, 


TYP. 


MAX. 


UK ITS 


Cycle Time 


T C vc 


1000 


— 


— 


son 


— 


— 


ns 


Clock Pulse Width <£l 
(Measured at V cc - 0.2V) <ji2 


PWHrf>l 
PWHrt2 
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215 
235 








ns 

ns 


Fall Time, Rise Time 

(Measured from 0.2V to V cc - 0.?V) 


Tf, T n 
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15 
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Del 3/ Time between Clocks 

(Measured nt o.?V) 


T B 





— 


— 





— 


— 


ns 



READ/WRIIE TIMING (LOAD = 1TTL) 



1 MHz TIMING 



2 MHi TIMING 



CHARACTERISTIC 


SYMBOL 


MIN. 


TYP. 


MAX. 


MIN. 


TYP. 


MAX. 


UNITS 


Read/Write Setup Time from 6508 


T-iwg 


— 


100 


3Q0 


— 


100 


150 


rs 


Address Setup Time from 6508 


Tads 
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— 


100 


150 


ns 


Memory Becici Access Time 


T «c 


— 


— 
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— 


— 
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ns 



■v 

n 

Z 

o 



Dale Stability Time Period 
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ns 

ns 


Delia Hold lims-Write 


Thw 
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— 


10 


30 


Da1a Selup Tine Irorn 6510 


Tmds 


— 


150 

30 
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— 


75 
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ns 


Address Hold Time 


Tha 
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10 
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ns 


R/W Hold Time 


Thrw 


to 


30 


— 


10 


30 




ns 


Delay Time, Address valid to 
4>2 positive transition 
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Delay Time, cf>2 positive transition 
to Dntn valid on bus 
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^_ 
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Delay Time, Data vatid to <f>2 
negative transition 
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to ipi'l positive transition 


Twe 
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SIGNAL DESCRIPTION 

The 6510 requires a two-phase non-overiapp^ng clock that rjns at the 
V cc voltage level. 

Address Bus (A -A JS J 

These outputs are TTL compatible, capable of driving one standard 
TTL oad and 130 pf. 

Data Bus (D -D ? ) 

Eight pir.s ere used for the data bus. This is a Bi-Direc:ional bus, 
transferring data To and from the device and peripherals. The outputs are 
tri-state buffers capable of driving one standard TTL load and 130 pf. 

Reset 

This input is used to reset or start the microp-ocessor from a power 
dawn condition. During the rime That this lire is held low. writing to or 
f'om the microprocessor is inhibited. When a positive edae is detected 
on the input, the microprocessor w'l' immediately begin *he reset 
sequence. 

Aftc o system initialization time o~ six clock cycles, llie musk interrupt 
flog w II be set and the microprocessor will load the program counter 
from the memory vector locations FFFC und FFFD. This Is the start loca- 
tion for program control. 

After V cc reaches 4.75 volts in a oower-up routine, resel must be held 
low for aT least two clock cycles At this time the R/W signal will become 
valid. 

When the reset signal goes high following these> 'wo clack cycles, the 
microprocessor will proceed with the normal reset procedure detailed 
Libove, 

Irttemjpt Request (IRQ) 

This TTL level input requests that an interrupt sequence hegin within 
the microprocessor. The microprocessor will complete the current in- 
struction being execuied before recognizing The request. At that rime, 
the interrupt mask bit in the Status Code Register will be examined. If 
ihe interrupt mask flag is net set, the microprocessor trill begin an inter- 
rupt sequence. The Program Counter and Processor Status Register are 
stored in I he stack. The microprocessor will then set The interrupt majk 
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flag high so rhar no further Interrupts may occur. Ar The end of rhis 
cycle, the program counter low will be loaded from address FFFE, and 
program ccmnrer high from location FFFF, therefore transferring pro- 
gram control to the memory vector located at ^hese addresses. 

Address Enable Control (AEC) 

The Address Bus is valid only when the Address Enable Central line 's 
high. When low, the Address Bus is in a high impedance state This 
feature allows easy DMA and multiprocessor systems. 

I/O Port [P„-P B ) 

Six pins are used for the peripherel po't, which con transfer data to 
or from peripheral dev ces. The Quloul Reyisle' is lata led in RAM at 
Add -ess 0001, and the Data Direction Register is at Address 0000. The 
outputs are capable at driving one standard TTL load anc 130 pf. 

Read/Wite (R/W) 

This signal is generated by the microprocessor to con-rol the direction 
of data Trcrsfers on the Dutc Bus. Tiis line is high eAtept when the 
microprocessor is writing to memory qr a peripheral device. 



ADDRESSING MODES 

ACCUMULATOR ADDRESSING — This -orm of addressing is represented 
wi'h a one byre instruction, Implying un operation on ihe Qcminulalur. 

IMMEDIATE ADDRESSING — In immediate addressing, the operand h 
contained in the second byte of the nstructton, with r,o further memory 
addressing required. 

ABSOLUTE ADDRESSING — In absolute addressing, the second byte of 
the instruction specifies the eight low order bits of the effective address 
while the third byte specifies the eight high orc.er bits. Thus, the absolute 
addressing mode allows access to the entire 65K bytes of addressable 
memory, 

ZERO PAGE ADDRESSING — The zero page instructions allow for shorter 
code and executior tinss by only fetching the second byte of the in- 
struction nnd assuming a zero high address byre. Careful use of the 
zero page can result in significant increase fn code efficiency. 
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INDEXED ZERO MGE ADDRESSING- ;x, Y indexha) — This form of 
addressing is used in conjunction with the index register and is referred 
to as "Zero Page, X" or "Zero Page, Y." The effective address Is calcu- 
lated by adding the serond fcyte to the contents of the index register. 
Since this is a form of "Zero Page" addressing, the content of 1he sec- 
ond byte refe r ences a location In pnge 7ero_ Additonally, due to the 
"Zero Page" addressing nature of this mode, no carry is added to the 
high order 6 bits of memory and <-rnK«Lingt of page boundaries does no' 
occur. 

INDEXED ABSOLUTE ADDRESSING— (x, f bMbwnfJ— This form of 

addressing is used in conjunction with X and f index register and is 
referred to as "Absolute, X," and "Absolute, Y." The effective address is 
formed by adding t.ne contenls of X and Y to the address contained in 
the second and third hytes of the instruction. This mode cllow; the index 
register to contain the index or count value and the instruction to contain 
the base address. This type of ndexing allows any oeation referencing 
and the index to modify multiple fields resulting in reduced coding and 
execution r'mpi. 

IMPLIED ADDRESSING — In the implied addressing made, the address 
containing the operand is implicitly statec in the operation code erf the 
instruction. 

RELATIVE ADDRESSING— Relative eddressing is used only with branch 
instrucliuris und esiublii-hes u destination for the conditional branch. 

The second byte of the instruction becomes the operand which is an 
"Offset" added to The consents of the iowe' eight bits of the program 
counter when the counter is sot at the next instruction. The range of the 
offset is —128 10 +127 byres from the next instruction. 

INDEXED INDIRECT ADDRESSING— in indexed indirect addressing (re- 
fe-red to as [Indirect, X]), the second byte of the instrLction is added to 
the contents of the X index regster, discording the carry. The result of 
this addition points to a memory location on page zero whose contents is 
the low order eight bits of the effective address. The next memory loca- 
tion in page zero contains rhe high order eigh- bits of the effective od- 
dross. Both memory locations specifying the high ard low o'der bytes of 
the effective address must be in page zero, 

INDIRECT INDEXED ADDRESSING — In indirect indexed addressing {re- 
ferred to as [Indirect], Y), the second byte of the instruction points to a 
memory location in page zero. The contents of this memory ocaTion is 
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cckfed to the contents: of the Y index register, the result being the low 
order eight bits of the effective address. The carry from this addition is 
added to the contents of the next page zero memory location, the result 
being the high order eight bits of the effective address. 

ABSOLUTE INDIRECT — The second byte of the instruction contains the 
low order eight bits of m memory location. The high order eight bits of 
thai memory location is contained in the third byte of the instruction. The 
contents of the fully specified memory location is the low order byre of 
the effective address. The next memory location contains the high order 
byte ot the effective address chichi is loaded irt'o the sixteen bits of tho 
program counter, 



INSTRUCTION SET — ALPHABETIC 
SEQUENCE 

ADC Add Memory to Accumulator with Carp/ 

AND 'AND" Memory with Accumulator 

ASL Shift Left Ore Bit (Memory or Accumulator) 

BCC Branch on Carry Clear 

DCS Branch on Carry $el 

BEQ Branch on Result Zero 

B T Test Bits in Memory with Accumulate 

BMI Branch on Result Minus 

BNE Branch on Result not Zero 

API Branch on Result Plus 

BRK Force Break 

BVC Rrnnch on Overflow Clear 

BVS Branch on Overflow Set 

CLC Clear Carry Flag 

CLD Clear Decimal Mode 

CLI Clear Interrupt Disable Bit 

CLV Clecr Overflow Flag 

CMP Comoare Memory and Accumulator 

CPX Compare Memory and Index X 

CPY Compare Memory and Index Y 
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DEC Decrement Memory by One 

DEX Decrement Index X by One 

DEY Decrement Index Y by One 

£OR "Exciu5ive-OR" Memory with Accurrufcitor 

INC Increment Memory by One 

INX Increment Index X by One 

I NY Increment Index Y by One 

J MP Jump To New Location 

JSR Jump to Me* Location Sewing Return Address 

LDA Lood Accumulator with Memory 

LDX Lood Index X vvfth Memory 

-DY Lood Index Y with Memory 

LSK Sri-H One Bit Right (Me-mory or Accumulator) 

NOP No Operation 

ORA "OR" Memory with Accumulator 

PHA Push Accumulator on Stock 

PHP Push Processor Stgtus on Stock 

PLA Pull Accumulator from Stock 

PLP Pull Processor Status from Stack 

ROL Rolale One Bit Left (Memory or Accumulator) 

ROR Rotate One Bit Right (Memory or Accumulator) 

RTI Return from Interrupt 

RTS Return from Subroutine 

SBC Subtract Memory from Accumulator with Borrow 

SEC S&t Carry Hog 

SED Set Decimal Mode 

SEI Set Interrupt Disable Status 

STA Store Accumulator in Memory 

STX Store Index X in Memory 

STY Store Index Y in Memory 
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TAX Transfer Accumulator 1c Index X 

TAY Transfer Aecumulctor to Inde* Y 

TSX Transfer Stack Pointer to Index X 

TXA Transfer Index X to Accumulator 

TXS Transfer ndex X to Stock Register 

TYA Transfer Index Y to Accumulator 



PROGRAMMING MODEL 
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APPLICATIONS NOTES 



Locating the Output Register at the rternal I/O Port h Page Zero 
enhances The powerful Zero Page Addressing instructions of the 6510. 

By assigning tic I/O Pin; as inputs (using the Data Direction Register; 
the user has T he ability to change the contents of address 0001 (ihe 
Output Register) using peripheral devices. THe ability ro change these 
contents usiny perirjlierol inputs, together with Zero Puye Indirect Ad- 
dressing instructions, allows novel and versatile programming tech- 
niques not possible ecrlier. 



COMMODORE SEMICONDUCTOR GROUP reserves the -ight to make changes to any 
products herein to Improve r eliat>ility, funcron or design. COMMODORE SEMICON- 
DUCTOR GROUP floes nc-- assume any llobll'ty o'lslng oji of th& applicator cr use of 
any product or circuit described hereii; nei-her does it convey any license under its 
parent rights nor the rights ot ofhe's. 
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6526 COMPLEX INTERFACE ADAPTER 
(CIA) CHIP SPECIFICATIONS 

DESCRIPTION 

The 6556 Complex Interface Adapter (CIA) is a 65XX bus compatible 
peripheral interface device with extremely flexible riming and I/O 
ca ^abilities. 

FEATURES 

• 16 Individually programmable I/O line* 

* 8 or 16- Bit handshaking on read or write 

* 2 independent, in kg We 16- Bit interval timers 

• 24-hour (A/WPM) time of day dock with programme ble alarm 

• 8-Bit shift register for serial I/O 

♦ 2TTL Load cwpabitiry 

* CMOS compatible l/O lines 

• ) or 2 ftAHt operation available 
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PIN CONFIGURATION 
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MAXIMUM RATINGS 

Supply Voltage, V cc 
Input/Output Voltage, V IN 
Operating Temperature, T ol , 
Storage Tempe-ature, T £TG 



-0.3V to +7.0V 

-0.3V to +7.0V 

0° C to 70° C 

~$b° C to 150° C 



All inputs contain protection circuitry Id .prevent damage due 10 high 
static discharges. Care should be exercised to prevent unnecessary ap- 
plication of voltages in excess of the allowable limits. 

COMMENT 

Stresses above those listed under "Absolute Maximjrn Ratings" may 
cause permanent damage to the device. These ore stress ratings only. 
Functional operation of this device at these or any older conditions 
above those indicated in the operational sections of this specification is 
not implied ortd exposure to absolute maximum rating conditions for 
extended periods may affect device reliability. 



ELECTRICAL CHARACTERISTICS (V cc ± 5%, V s . = O V, T A 
= 0-70°C) 



CHARACTERISTIC 


SYMBOL 


MIN. 


TYP. 
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Input High Voltage 
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CHARACTERISTIC 


SYMBOL 


M!N. 
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Output Low Voltage 
V 00 = (WIN, l l0( , < 3.2 mA 
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Output High Current (Sourcincj); 
V 0H > 2-AV (PAD-PA/, 
PB0-PB7, PC, DB0-DB7 
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6526 INTERFACE SIGNALS 

<j>2 — Clock Input 

The <}t7- clock is a 7TL compatible input used for internal device opera- 
tion and as a timing reference for communicating with 'he syslem dala 
bus. 

C5 — Chip Select Input 

The CS input controls the activity of the 6526. A low level on CS while 
$2 Is high causes the device to respond to signals on the R/W and ad- 
dress (RS) lines. A high en CS prevents these lines from controlling the 
6526. The CS line is normally activated (low) ot $2 by the appropriate 
address combination. 

R/W — Read Write Input 

The R/W signal is normally supplied by the microprocessor and con- 
trols the direction of data transfers o~ the 6526. A nigh on R/W indicates 
a read {data transfer out of the 6526), while a low indicates a write 
(data transfer into the 6526). 

RS3-RS0 — Address Inputs 

The address inputs select the internal registers as described by I he 
Register Wop. 

DB7-BD0 — Dalu Bus Inputs/Outputs 

The eight data bjs pins transfer information between the 6526 and 
thft system da-a bus. These pins are ligh impedance inputs unless CS is 
low and ft/W and <ji2 are high to read the device. During this read, the 
data bus outpjt buffers are enabled, driving the data from the selected 
register onto the system data bus. 

IRQ — Interrupt Request Output 

IRQ is an open drain output normolly connected to the processor inte'- 
rupt input. An external pullup resistor holds the signal high, allowing 
multiple l°.Q outputs to oe connected together. The IRQ output is nor- 
mally off (high impedance] arid is uclivuled low as indicated in the 
functional description. 
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RES — Reset Input 

A low on the \itS pir resets oil internal registers. The port pins are set 
as inputs and port registers to zero talthojgh a read of the ports will 
return oil highs because of passive pullups) The timer control registers 
are set to zero and the timer latches to o'l ones. All other registers are 
reset to zero. 



6526 TIMING CHARACTERISTICS 
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Symbol 


Characteristic 


lMHi 


2MHt 


Unit 


MIN 


MAX 


MIN 


MAX 


Tacc 


Data Access fram 








' 




RS3-RS0 


— 


550 


— 


275 


ns 


T co (3) 


Daiq Access f ron 














cs 


— 


320 


— 


150 


ns 


Tdr 


Duk; Release "Tme 


50 


— ■ 


25 


— 


ns 



NOTES 


1 


— All timings 


■tirp rpf e r^nc ed from 


V t ma* ond V^, min 


1T 


tfipu 


s and V 


OL 






max 


and ' 


/ 0h . mrn on output*. 


















2- 


— *WCi 


i mec"sura<J from "he laler 


of <£2 h 


gh 


sr CS low, 


rs 


rntst 


bi law 


erf 






leatf 


until 


he *rid of <^3 high. 


















a 


— Tgg i 


mco 


ajrcd from ths lolcr 


of <$■£ ^igh 


cr C£ tew 














Velic 


data 


is available only aft 


cr the 1 


jtt ■- 


°f Tndq otr 


T. 


j* 

















REGISTER MAP 


RS3 


RS2 


R51 


RSO 


?EG 


NAME 



















PRA 


PERIPHERAL DATA REG A 











1 


1 


PRB 


PERIPHERAL DATA REG B 








1 





2 


DDR A 


DATA DIRECTION 3CG A 








1 


1 


3 


DDRB 


DATA DIRECTION 3EG B 





1 








4 


TA LO 


TIMER A LOW REGISTER 





1 





1 


5 


TA HI 


TIMER A HIGH REGISTER 






I 
1 


1 





6 


TB LO 


TIMER B LOW REGISTER 


1 


1 


7 


TB HI 


TIMER B HIGH REGISTER 













3 


TOD 1 OTHS 


10TH5 OF SECONDS REGISTER 










1 


9 


TOD SEC 


SECONDS REGISTER 







1 





A 


TOD MIN 


MINUTES REGISTER 







1 


1 


E 


TOD HR 


HOURS— AMVPM REGISTER 




1 








C 


SDR 


SERIAL DATA REGISTER 




1 





1 





ICR 


INTERRUPT CONTROL REGISTER 




] 


1 





E 


CRA 


CONTROL REG A 




1 


1 


1 


F 


CRB 


CONTROL REG B 



424 



APPENDIX M 



6526 FUNCTIONAL DESCRIPTION 

I/O Ports (PRA, PRB DDRA, DDRB). 

Ports A and 5 eacn consist cf an fj-bit Periphera Da1a Register (PR) 
and on 8- bit Data Direction Register (DDR). If a bit in tries DDR is set to a 
one, the corresponding bit in the PR is an output; if a DDR bit is set to a 
zero, the corresponding PR bit is defined as arv input. On o READ, the PR 
reflects the infprrration present on the ucluul poit pins (PAO — PA7, 
PBO — PB7) for both input and output bits. Port A and Port B hove passive 
pull-up devices as well as active pull-ups, providing both CMOS und TTL 
compatibility- Both ports have two TTL load drive eapcbility. In oddition 
Ig ri'jriricil I/O operation, PE6 and PD7 also proviae timer output func- 
tions. 

Handshaking 

Handshaking on data transfers can be accomplished irsing trie PC 
output pin nnd the FLAG input pin. PC will go low for oris cycle following 
a reed or write of PORT B, This signal can be used to indicate "data 
ready' ct PORT B or "data accepted" from PORT B. Handshaking or 
16 bit date transfers (using both PORT A and 'ORT B) it possible by 
always reading or writing PORT A first. FLAG is a negative edge sensi- 
tive input whicn can be used for receiving the PC output from another 
6526. ar as a general purpose interrupt input. Any negative transition of 
FLAG will set the FLAG interrupt bit. 
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DPA £ 


DPA T 


DPAo 


3 


DDRB 
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DPB« 


DPB S 


DPB 4 


DPB 3 


":pr e 


DPR., 
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Interval Timers {Timer A, Timer B) 

Each interval timer consists of a )6-bit read-only Timer Counter and a 
16-bit write-Dnly Timer Lorrh. Dale written to the timer are latched in the 
Tinner Latch, while data read from the timer are the present contents of 
the Time Counter. The timers can he used independently or linked ■'or 
extended operations. The various timer modes allow generation of long 
time delnys, variable width pulses,, pulse trains and vaiable frequency 
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waveforms. Utiiitiricj llie CNT input, the imers can count externcl pulses 
or measure frequency, pulse wid*h and delay times of external signals. 
Ea-h limer has un associated control register, providing independent 

control of the following functions: 

Start/Stop 

A control bir allows the timer to be slcrted or stopped by the rrvcro- 
processor at any time, 

PB On/Off: 

A control bit allows the timer output to appear on a PORT E output 
line (PBc fui TIMER A end PB7 Tor TIMER B). This function overrides rhe 
DQRB control tori one forces the approprate PB line *o an cutput. 

Toggle Pulse 

A control bit selects the output applied to PORT B. On every timer 
underflow the output can either toggle or generate a s'ngle positive 
pu se of one cycle duration. The Toggle output is set high whenever rhe 
timer is started and is set low by RES. 

One-Shot Continuous 

A comrol bit selects either timer mode. In one-shot mode, the time'' 
will COUnl down from ihe bitched value to £ero, generate an interrupt, 
reload the latched value, then stop. In continuous mode, the timer will 
count from the latched value to zero, generate an interrupt, reload the 
latched va ue and repeat the procedure continuously. 

Force Load 

A strobe bir allows the time'- larch to be loaded into rhe rimer counter 

at cry time, whether the timer is running or ior, 

Input Mode: 

Control bits allow selection of the clock used to decrement the timer. 
TIMER A tan count <£>2 dock pubes or external ptils&i applied to the CfMT 
pir. TIMER B can count tt>2 pulses, external CNT pulses, RAAbR A under- 
flow pulses or TIMER A underflow pulses while the CNT pin is held high. 

The -timer latch Is loaded into the tlrrer on any timer unde'flow, on a 
fcrce load or following u write to ihe high byle of the presenter while the 
timer is stooped. If the timer s running, a write to the high byte will lood 
the timer latch, but not reload the counter. 
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READ (TIMER) 

REG NAME 



4 


TA LO 


TALj 


TAL, 


TAL, 


TAU 


TAL, 


TAL 2 


TAL, 


TALj 


5 


TA HI 


TAH 7 


TAH 6 


TAH 5 


TAH^ 


TAH 3 

TBL 


TAH 2 
TBU. 


TAH, 


TAH 


6 


TB LO 


TBL T 


TBL* 


TBL, 


TBL, 


TBL, 


TBL„ 


7 


TB HI 


TBH 7 


TBH S 


TBH 5 


TBH„ 


TBH a 


TBH 3 


TBH, 


TBH 



WRITE (PRESCALER) 

REG NAME 



4 


TA LO 
TA HI 


PAL, 

PAH 7 


PAL, 

PAH 6 


PAL 5 

PAH; 


PAL, 


PAL 3 


PAL 2 


PALt 


PAL^ 


5 


PAH, 


PAH a 


PAH 2 


PAH, 


PAH 


6 


TB LO 


OBL 


PBL e 


PBL 5 


PBL 4 


PEL; 


PBL 2 


PBL, 


PBL, 


7 


TB HI 


PBH T 


PBH 6 


PBH 5 


PBH„ PBH 3 


PBHj 


PBH, 


PBH 



lime of Doy Clock (TOD) 

The TOD clock is a special purpose timer for real-time appications. 
TOD consists of a 24-hour (AM/PM) clock with 1/1 3th second ■"esolution. It 
is organized into 4 registers: lOths of seconds, Seconds, Minutes and 
Hours. The AM/PM flag is in the MSB of "he Hours register for easy bit 
testing. Each register reads out in BCD format 1a simplify conversion fa" 
driving displays, etc. The clock requires an external fVO Hz or 50 H7 
(programmable) TTL level input on the TOD p"n for cccurate time- 
keeping. In addition to time-keeping, a programmable ALARM is pro- 
vided for generating an intcrupt at a desired time. The ALA3M registers 
are located cure same addresses as the corresponding TOD registers. 
Access to the ALARM is governed by a Control Register bit. The ALARM 
is write-only; any read of a TOD address will read time regardless of the 
state of the ALARM access bit. 

A specific sequence of events must be followed for pre per seiting ord 
reading of TOD. TOD is autsma'ivall/ stepped whanever a w'ite to "he 
Huurs reyisfet occurs. The cluck /will nol slort uyuin jnlil uflei u wrftfi 'o 
the lOths of seconds register. This assures TOD will always start at the 
desired time. Since a carry from one stage to the next can occur at any 
time with respect to a read operation, a latchirg function is included _ o 
keep all Time Of Doy informer ion constant during a read sequence. All 
four TCD registers latch on a 'ead of Hours and remain latched until 
after a read of lOths of seconds. The TOD clock continues fa count when 
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the output registers are latched. If only one register Is fo be read, There 
is no ca'ry problem and the register can be read "on the fly," provided 
that any read of Hours is followed by a read of IQths of seconds to 
disable the latching. 

READ 

REG NAME 



8 


TOD I0THS 














T 8 


T< 


T 2 


Ti 


9 


TOD SEC 





SH 4 


SH 2 


SH, 


SL 6 


SL 4 


SL 2 


SL, 


A 


TOD WIN 





MHt 


MH 2 


MM, 


MU 


ML, 


ML 2 


ML, 


B 


TOD HR 


PA/1 








HH 


HL 3 


HU 


Hl 2 


HL, 



WRITE 

CRB 7 = TOD 

rRB 7 = 1 ALARM 

[SAME FORMAT AS READ) 

Serial Port (SDR) 

The serial port is a buffered, 8-bit synchronous shift register system. A 
control bit selects input or output mode. In input mode, data on trie SP 
pin is sniffed into the shift register en the rising edge cf the signnl 
applied to the CNT pin. After 8 CNT pulses, the dcta in the shift register 
is dumped into the Serial Date Register and an interrupt is generated, fn 
the output mods, TIMER A is used for the baud rate generator. Data is 
shifted out nn the EP pin aT Vi the underflow rate of T IM£R A. The 
™ximum bcud rate possible is if>2 divided by 4, but the maximum use- 
able baud rate will be determined b', line loading and the saeed at 
which the -eceiver responds to input data, Transmissicr will star follow- 
ing a write to the Serial Da1u Reyiiler (provided TIMER A is running and 
in continuous model . The cloc<: signal derived from TIMER A appears as 
an outpu* an the CNT prn. The data in the Serial Data Register will be 
'oaded rto the shift reg ste' then sn ft out to the SP pin when a CNT 
pulse occurs. Data shifted cut becomes valid on the falling edge of CNT 
and remains valid until the ne*t falling edge After 8 CNT pulses, an 
interrupt is generated to indicate mo-e da-a con be sent. If the Serial 
Data Register An? loaded with new information prior to this interrupt, 
the new data will automatically be loaded into the shift registe' and 
transmission will continue I* the microprocessor iLtnys one byte nhec.d of 
the shift register, transmission will be continuous. If no fj^her data is to 
oe transmitted , after the 8th CNT pulse, CNT will return high r.nci SP will 
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remain at the level of the last data bit transmitted, SDR data is shitted 
out MSB first and serial input data should also npaeur in I his formal. 

The bidirectional capability of the Seria Port and CNT clock oilows 
many 6526 devices to be connected to a common serial communication 
bus on which ore 6526 acts as a master, sourcing data aid shift clock, 
while all other 6526 chips act as slaves. Both CNT ana SP outputs are 
open drain to allow such a common bus. Protocol far master/slave 
selection con be transmitted over _ he serial bus, or via dedicated hand- 
shaking lines. 



REG 



NAME 



SDR 



5~ 



5* 



interrupt Control [ICR) 

There are Five sources of interrupts on the 6526; underflow from TIMER 
A, underflow from TIMER B, TOD ALARM, Serial Port fullyernpty and 
FLAG. A single register povides masking and interrupt information. The 
interrupt Control Kegister consists of a writs-only MASK register and a 
read-only DA~A register. Any interrupt will set the corresponding bit in 
the DATA register. Any irterrupt whim is enabled by the MASK register 
will set the IR bit (MSB) of the DATA register and bring the IRQ pin low. 
In a muti-chip system, the IR bit con be polled to detect which chip has 
generated an inter-upt request. The interrupt DATA register is cleared 
and The IRQ line returns high Following u reod uf ihe DATA register. 
Since each interrupt sets an irterrupt bit regardless of the MASK., and 
each 'nterrupt bil can be selectively masked to prevent the generation of 
a processor interrupt, it is possible to Intermix polled interrupts with true 
interrupts. Hcweve - , pclliny ihe IR bil will cause the DATA register to 
clear, therefore, ft is up to the user to preserve the information con- 
tained In the DATA register If any polled interrupts were present. 

The MASK register provides convenient control nf individual mask bits. 
When writing to the MASK register, if bit 7 (SET/CLEAR) of the dots 
wri~ten is a 7EPO, any mask bit written with a one w"ll be cleared, while 
those mask bits written with a zero will be unaffected. If bit 7 of the 
data written is a ONE, any mask bit written with a one will be set, while 
those mask b'ts written with a zero will be unaffected. In order for an 
Interrupt flag to set IR and generate fin Interrupt Request, the co-re- 
sponding MASK bit must be set. 
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READ (INI DATA) 

REG NAME 



D 


ICF 


IR 








FLG 


EP ALRM 


TB 


TA 



WRITE (INT MASK) 
REG NAME 



□ 


ICR 


S/C 


X 


X 


FLG 


SP j ALRM 


TB 


TA 



CONTROL REGISTERS 

Tnere ore two control registers in the 6526. CRA end CRB. CRA is 
associated with TIMER A and CRB is associated with TIMER B. Th» regis- 
ter format is as follows: 



CRA: 

Bit- Name 

START 



PBOM 



2 
3 

4 


OLJTMODF 
RUNMODE 
IOAD 


5 


INMODE 


6 


SPMODE 


7 


TODIN 



Function 

1=START TIMER A, 0=STOP TIMER A. This bit is 

nutcmnricolly reset wrien underflow occurs during 

one-shot mode. 

1 =TIVlFR A nurput appears on PB6, 0=PB6 no'mal 

operation, 

-TOGGLE, 0=PULSE 
l=OME-SHOT, 0-CONTINUOUS 
l=FORCE LOAD (this is a STROBE input, there is nu 
data storage, bit 4 will always read back a zero 
and writing a iero hus no effect}, 
i = TIMER A counts posi-ive CMT transitions, 0= 
TIMER A counts (£2 pulses. 
1=SERIAL PORT output (CNT sources s=hift dock), 

— SERIAL PORT input 'externa! shift duck required), 

1 — 50 Hz clock requirec on TOD pin tor accurate 
time, = 60 Hi clock required un TOD pin for accu- 
rate time. 
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CRB: 



Bit Nome 



5,6 IWMODE 



7 ALARM 



Function 

(Bits CRB0-CR64 are identical to CRA0-CKA4 for 
TIMER B with the exception that bit 1 controls the 
output of TIMER B on PB7). 

Bits CRB5 and CRB6 select one ot tour input modes 
for TIMER B as; 



CKB6 





CRB5 





TIMER B counts <$2 pulses. 

TIMtK B counts positive CNF 

translations. 

TIMER B counts TIAAEC A 

underflow cubes. 

TIAAFR B count? TIMER A 

underflow pulses whife CNT is 

high. 
1 ^writing to TOD reg'sters sets ALARM, 0=writing 
to TOD registers sets TOD clock. 



! 



1 



TOO 
RIG NAME IN 



SP 

MODE 



IN 

MODE LOAD 



RUN OUT 
MODE MODE 



PB ON START 



E 


CFW 


0=OOHz 


0-IMPUT C=lf2 


l=FOECE 


0=COHl. 


Q=PmSE 


o=p&,orr 


0-STOP | 






1=501-7 


1 =OLTFLT. 1=CNI 


[5IROBB 


i=as. 


1 -IO<J<*E 


l^PCDN 


l=5IAKI 



- TA- 



RES NAME ALARM IN MODE 



LOAD 



RUN 
MODE 



OUT 

MODE 



PB ON 



START 



f 


CRB 


O-TOD 




1 


0— 42 
l-CNT 

0-TA 


-F05CE 

LCA3 


o-;omi. 


(J-PULSE 


0- '67 OFF 


0-S1OP 






1- 


! 


l=CMr-TA 


<$7R33E) 


1=D,S. 


1=TQGCLE 


l=PB, DN 


1 - START 






ALARW 

















-TB- 



All unused register bits are unaffected by a write or.d arc forced to zero 
an a read. 



COMMODORE SEMICONDUCTOR GROUP reserves the right to ma<e changes to any 
product herein lu IrYlpreva reliability, function or design. COMMODORE SEMICON- 
DUCTOR GROUP does not ussune uny iubilily urising uul uf lliw urjutiuuliun ur use uf 

any product or circuit described herein; neither does it convey any license jnde' It; 
patent rights nor the *ights of others. 
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APPENDIX N 

6566/6567 (V1C-II) CHIP 
SPECIFICATIONS 

The 6!>66/fi56/ are multi-purpose color video controller devices for use 
in both computer video terminals and video game applications. Both 
devices contain 47 control registers which are acceded via a standcrd 
3-bit microprocessor bus (65XX) and wi 1 ! access up to I6K of memory 
'or Hisplny informntion. The uorimis operating morfss find nptions within 
eaci mode are described. 



CHARACTER DISPLAY MODE 

In the character display mods, the 65*6/6567 fetches CHARACTER 
POINTERS from Hie VIDEO MATRIX area of memory and translates the 
pointers to character dot location addresses in the 2048 byte CHAR- 
ACTER BASE orea of remory. The video matrix is comprised of 1000 
consecutive locations in memory which each contain an eight-bit char- 
acter pointer. The location of the video matrix within memory Is defined 
by VAA13-VM10 in register 24 (Si 8) which are used as the A MSB o* the 
video matrix, oddresi. The lower order 10 bits are provided by an Inter- 
nal counter (VC3 — VC0) uvhirh steps through the 1000 chnrncte- locci- 
tions. Note that 'he 6566/6567 provides 14 address outputs,; the-efore, 
additional system hardware may be required for complete system 
memory decodes. 

CHARACTER POINTER ADDRESS 



A13 
VM1 3 VW1 



A12 
2 



All 

VM11 



A10 A09 
VM10VC? 



AD8 


A07 


A06 


ACS ' A(U 


AD3 


AO'i AOI 


AGO 


VCS 


VC7 


VC6 


VC5 VC4 


VC3 


VC2 VCT 


VCO 



ij* 
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The eight-bit character pointer permits up to 256 different character 
definitions to be available sirruhaneously. Each character is on OxS dot 
matrix stored in the character base as eighi consecutive bytes. The Incn- 
Hori of the character base is defined by CB13— CE1 1 also in register 24 
($18) which or* jsed for the 3 most significant bits (MSB) of the char- 
acte' base address. The ) 1 lower order addresses ore forrred by the 
8-bit character pointer from the video matrix (D7-D0) which selects a 
porticular character, and a 3-bit roster counter (RC2-RC0) which seleds 
one of the eight character bytes. The resulting characters are formatted 
as 25 rows of 45 characters each. In addition to the 3-bit character 
pointer, a 4-bit COLOR NYBSLE is associated with each video matrix 
location (the video matrix memory must be 12 bits wide] which defines 
one of sixteen colors for each character 

CHARACTER DATA ADDRESS 



A13 


A12 


All 


A10 


AO? 


A08 


A07 


A06 


A05 


A04 


A03 


A02 ! A01 


AW 


CB13 


CBI2 


CBII 


D7 


DA 


OS 


U4 


D3 


D2 


ai 


DO 


RC2 BC1 


KCO 



STANDARD CHARACTER MODE (MCM - BMM = ECM = 0) 

In the standard character mode, the 8 sequential bytes from the 
character base are displayed directly on the 8 lines in each character 
regicr. A "0" bit causes the background #0 color (from register 33 
($21)) to be displayed while the color selected by the color nybble 
(foreground) is displayed for a "1" bit (see Color Code Table). 



FUNCTION 
Background 

: o re ground 



CHARACTER 
BIT 



1 



COLOR DISPLAYbU 



Background #0 color 

;regisier 33 ($21)) 

Color selectee by 4-bit color nybble 



Therefore, each character has a unique eolar determined by the 4-bit 
rnlnr nybble (1 of 16) and all rharncrers share the common background 
color. 
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MULTI-COLOR CHARACTER MODE [MCM = 1, RMM = ECM 
= 

Multi-color mode provides additional color flexibility allowing up to 
four colors within each character but with reduced resolution. The 
multi-coior mode is selected by setting the MCM bit in register 22 ($16) 
to "1," which causes the dot data stored : n the character base to be 
interpreted in a different manner, If the MSB of the color nybble is a 
"0," the character will be displayed as described in standard character 
■node, allowing the two modes to be inter-mixed (however, only the 
ower order 8 colors are available). When the A1SB of the color nybble is 
a "1" (if MCM:MSB(CM] — I) the character bits are interpreted in the 
multi-color mode: 





CHARACTER 




FUNCTION 


BIT PAIR 


COLOR DISPLAYED 


Background 


00 


Background #0 Color 
[register 33 ($21)) 


Background 


01 


Background # 1 Color 
[register 34 ($22)) 


Foreground 


10 


Background #2 Color 
[register 35 ($23)) 


Foreground 


11 


Color specified by 3 LSB 
L>f color nybble 



Since two bits are required to specify one dot color, the charocte' is now 
displayed os a 4 X 8 mntrix with each dnt 1wic« the horizontal size as in 
stardard mode. Note, however, *hat each charocte" region can now 
contain d different colors, twa «5 foreground end two as background 
(see MOB priority), 

EXTENDED COLOR MODE (ECM - 1, BMM = MCM = 0) 

The extended color mode allows the selection of individual back- 
ground colors for enrh rhararrer region with the normal S X 8 character 
resclu'ion. This rrode is selected by setting the ECM bit of register 17 
($11) ro "]/' The character do1 dcita is displayed as in the standard 

ir ude (furey ruuid color determined by the color nybble is displayed for 
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a "I " data bit), but tlie 2 MSB of the Chcracter pointer are used to select 
the bnclcg round color -for each character region as follows; 



CHAR. POINTER 
MS BIT PAIR 



00 
01 
10 
11 



BACKGROUND COLOR DISPLAYED FOR BIT 



Background #0 color (register 33 ($21)) 

Background #J color (register 34 ($22)) 

Background #2 color (register 35 ($23)) 

Background #3 color (regis-er 36 l$2A)) 



Since the two MSB of the character pointers are used fur color informa- 
tion, only 6A different chnracter definitions are available. The &5A6/65&7 
will force CB1 and CB9 to "0" regardless of the original pointer values, 
so that only the first 6d character definitions will be accessed. With ex- 
tended color mode each character has one of sixteen individually de- 
fined foreground colors and ons of the four available background 
colors. 



NOTE: Extended color mode and multi-coloi mode should not be enabled 
simuttaneousiy 



BIT MAP MODE 

In bit Trap mode, the 6566/6567 fetches data from memory frv a dif- 
ferent fashion, so that a one-to-one correspondence exists between 
each displayed dot and a memory bit. The bir map mode provides o 
Screen resolution of 320H X 200V individually controlled display dots. 
Bit map mode is selected by setting the BMM bit in register 17 <$l |j ig q 
"I." The VIDtO fWAI WIX is still accessed as in character mode, but the 
video matrix data is no longer interpreted as character pointers, but 
rnther as color data. The VIDEO MATRIX COUNTER is then also used as 
an address to fetch the dot data for display from ihe 9000-byte DISPLAY 
BASE, The display base address is formed as follows: 



Al3 


AI2 


All 


A10 


A09 


AOE A07 


A06 


A05 


A04 


A03 


A02 


AC I 


A00 


CB13 


VC9 


vca 


VC7 


VCfi 


VC5 MCA 


VC3 


VC2 


VC1 


vco 


RC2 


RC1 


RCO 
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VCx denotes ilit* video matrix counter outputs, RCx denotes the 3-bit 
raster lire counter and CB13 is from register 2-i ($3 3). The video matrix 
counter steps through trie same 4Q locutions for eight raster lines, con- 
tinuing to fie next 40 locations every eighth line, while the roster counter 
increments once for ecch horizontal video line (ruster line). This address- 
ing rpsults in ench eight sequential memory locations being formatted as 
an S X S dot block on the video display. 



STANDARD BIT MAP MODI (BMM =1, MCM = 0) 

When standard bit map mode is in use, the color information s de- 
rived only from the darn stored in the video matrix (the color nybble is 
disregarded]. The 8 bi-s are divided into two 4-bit nybbles which allow 
two rn nrs to he independently selected in each 8X8 dot block When 
a bit in the display memory is a "0" the color of *he output dot is set by 
the least significant (lower) nybble (LSN). Similarly, a display memory bit 
of "]" selects the output color determined by the MSN (upper nybble). 



BIT 



DISPLAY COLOR 





1 



Lower nybble of video matrix pointer 
Upper nybble of video rnotnx painter 



MULTI-COLOR BIT MAP MODE {BMM = MCM = 1) 

Multi-colored bit map mode h selected by setting the MCM bit in 

reyisler ZZ ($16) lo a "1" in conjunction with llie BMM bit. Multi-color 
made uses the same memory cccess sequences as standard bit map 
mode, but interprets the dot data a* follows; 



BIT PAIR 


DISPLAY COLOR 


DO 


Boc kg round #0 color (register 33 ($21)) 


01 


Upper nybble of video matri*. pointer 


10 


Lower nybble of video matrix pointer 


11 


Video matrix color nybble 



Note that the color nybble (DB11 DBS) IS used for the multi-calor bit 
map mode. Again, as two bits o'e used ta select nne dnt color, the 
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horizontal dot size is doubled, resulting in a screen resolution of 160H X 
200V. Utilizing multi-color bit map mode, three independently selected 
cobra can be displayed ir. each 8X8 block in addilion to the back- 
ground color, 



MOVABLE OBJECT BLOCKS 

The movable object block (MOB} h a special type of character which 
can be displayed at any one position on the screen without the block 
constraints inherent in character and bit map mode. Uo to 8 unique 
AflOBs can be- displayed simultaneously, each defined by 63 bytes in 
memory which are displayed cs a 24X21 Jul array (shown below), A 
number of special features make W.OBs especially suited fo- video 
graphics and gone applications, 





MOB DISPLAY BLOCK 




BYTE 


BYTE 


BYTE 


00 


01 




02 


03 




04 




05 


57 




58 




59 


60 




61 




62 



ENABLE 

Each MOB can ae selectively enabled for display by iertincj lis corre- 
sponding enable bit (MnE} tn "1" in register 21 ($15). If the MnE bit is 
"0," no MOB aperctions will occur involving the disabled MOB, 

POSITION 

Each MOB is oositioned via its X and Y position register (see register 
map) with a resolution cf 512 horizontal and 256 vertical positions. The 
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position of o MOB is determined by the upper-left corner of the array. X 
locations 23 to 347" ($17-$)57) and Y locations 50 to 249 (S32-SF9) are 
visible. Since not ell available MOB positions arc entirely visible on the 
screen, MOBs may be moved srmccthly on and off the display screen. 

COLOR 

Each MOB has o separate 4-bi* registe" to determine the MOB color. 
The two MOB color modes arc; 

STANDARD MOB (MnMC - 0) 

In the standard rncde, a "0" bit of MOB data allows any background 
data lo shyw through (transourenl) uric u "I" bii is displayed as lilt: 
MOB color de'ermined by the corresponding MOB Color register. 

MUffl-COLQR MOB (MnMC = 1) 

Each MOB can be individually selected as a multi-color MOB via 
MnMC bits in the MOB Multi-color register 28 ($1C). When the MnMC bit 
is "I," the corresponding MOB is displayed in the multi-color node. In 
the multi-color mode, the MOB data is Interpreted h pairs (s'milar to the 
other multi-color modes) as follows: 

BIT PAIR | COLOR DISPUTED 

00 Transparent 

01 MOB Multi-color #0 [register 37 ($25)) 

10 MOB Color [registers 39-46 (S27-S2EJ) 

1 1 MOB MuHi-Lulyr #1 (register 33 ($26)) 

Sines Iwu bits vf dalu are required for each color, the resolution of the 
MOB is reduced to 12X21, with each horizontal dot expanded to twice 
standard s : ze so that the overall MOB size does not charge. Note that 
up trj 3 colors can be displayed in each MOB (in addition to transparent) 
but tha - two of the colors are shared among all the MOBs in the multi- 
color mode. 
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MAGNIFICATION 

Each MOB con be selectively expuuded (2x) in bolh the horizontal 
and Vertical directions. Two registers contain the control bits 
(MnXE.MnYE) -for the magnification control; 



REGISTER 



23 ($17) 
29 ($!£» 



FUNCTION 



Horizontal *xpnrd MnXE — " T'^expand; "0"=normal 
Vertical expand MnYE— J T'=expand; "0"- normal 



When MOBs are expanded, no increase in resolution is realized. The 
same 24X21 array (T2x21 if multi-colored) s displaced, but the overall 
MOB dimension is doubled in the desired direction (the smallest MOB 
dot may be up To dX ttnndnrd dot dimension if a MOB is both multi- 
colored and expanded), 

PRIORITY 

The priority of each MOB may be individually controlled with respect 
to the other displayed information from character or bit map modes. 
The priority of each MOB is set by the corresponding bit (MnDP} of regis- 
ter 27 (SIB) cs follows: 



REG BIT 



PRIORITY TO CHARACTER OR BIT MAP DATA 



Non-transparent MOB data will be displayed (MOB in front) 
Non-trunsparent MOB data will be displayed only instead of 
tikgd #0 or multi-color bit pair 01 (MOB behind) 

MOB — DISPLAY DATA PRIORITY 



MnDP = 1 


MnDP = 


MQBn 

Foreground 

Background 


Foreground 
A/lQBn 

Background 
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MOB dnta bits, of "0" "00" in muti-color mode) are transparent, always 
permitting any other information to oe displayed. 

The iViOBs have a fixed priority with rwspftCt to each other, with MOB 
Saving the highest priority and MOB 7 The lowest. When MOB data 
(except transparent data) of two MOBs are coincident, the data frnm 
the lower number iWOB will be displayed, MOB vs. MOB dcta is 
prioritized before priority resolution with character or bit mop dotn. 



COUJSION DETECTION 



Two types of MOB collision (coincidence! are detected, MOB to MOB 
collision and MOB 1c display data collision: 



1) A col man baKveen two MOBs occur; when non-trensparent output 
data of two A^OBs are coincident. Coincidence cf MOB transparent 
areas will not generate a collision. When a collision occurs, the 
MOB bits (MnM) in the MOB-MOD COLLISION registe- 30 ($1E) will 
he set to "1" tor both colliding MOBs. As a coll is on between two 
(or more) MOBs occurs,, tie M03— MOB collision bit fo' each col- 
lided MOB will be set. The co His on hits remoin set nnti n read of 
the collision register, when all bits are automatically cleared. 
MOBs collisions a'e detected even if positioned <-.ff-srresn_ 

2) The second type of collision is o MOB DATA col ision between a 
MOB and foreground display data -ram the character or bit map 
maces. The MOB-DATA COLLISION register 31 ($1F) has a bit 
(MnD) for each MOB which is set to "1" when both the MOB und 
non-background d'splay data are coincident. Again, the- coinci- 
dence of only Transparent data does not generate a collision. For 
special applications, the- dsplay data from the 0—1 multicolor br 
pair a so does not cause a collision. This feature permits their use 
as background display data without interfering with true MOB col- 
lisions. A MOB-DATA collision can occur olf-screen in the horizon- 
tal d rection if actual display data has been scrolled to on off- 
screen position [see scrolling), The iViOD— DATA COLLIS ON register 
also automatically clears when rood. 
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The collision interrupl latches are set whenever trie first oft of either 
register is set to "1." Once any collision bit within a register is set high, 
subsequent collisions will not set the interrupt latch until that collision 
register has been cleared to air "Os" by a read. 

MOB MEMORY ACCESS 

The data for each MOB is stored in 63 consecutive oytes of memory. 
Each block of MOB data is defined by a MOB pointer, located at the 
end of the VIDEO MATRIX. Only 1000 bytes of the video matrix are used 
rn the normal display modes, a lowing the video matrix locations 
1016-1023 (VM base + $3F8 to VM bnse-$3FF) to fce used for MOB 
pointers 7, respectively. The eight-bit MOB pointer from ihe video 
matrix together with the six fctits fmm the MOB byte counter (to address 
63 bytes) define the entire T^-bit address field: 



A13 



AAF7 



A12 



MP6 



All AlO 



MPS MPd 



A09 A0S 



MP3 MP? 



A07 



MP1 



A04 



MPQ 



A05 



MC5 



A04 A03 



MC4 MC^ 



A02 



MC2 



AC1 A00 



MC1IMCQ 



Whe r e MPx are the MOB pointer bits from the video matrix and AAO are 
the internally generated MOB counter bits. The MOB pointers are read 
from the videu matrix ul trie end o*" ever/ raster line. When the Y posi- 
tion 'agister of a MOB matches the current roster line count, the actual 
fetches of MOD data begin. Internal counters automatically step through 
the 63 bytes of MOB dala, displaying three bytes on each raster line. 

OTHER FEATURES 

SCREEN BLANKING 

The display strssn iTuy be blunked by setting the DEN bit in register 
I/ ($1 1) to a "0" When the screen is blanked, the entire screen will be 
filled with the exterio- color as set ir registe" 32 $20). When blunkina. is 
active, only transparent (Phase II memory accesses are required, per- 
mitting f jll processor utilization of -he system bus, MOB data, however, 
will be accessed If the MOBs ore not also disabled. The DEN bit must be 
set ^o "1" for normal video display, 
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ROW/COLUMN SELECT 

The norma] display consists of 25 rows of 40 characters lor character 
regions) per row. For special display purposes, ihe display whdow may 
be reduced To 24 rows and 38 characters. There is no change in the 
formot of fhe displayed information, except thcrr characters (bits) adja- 
cent to the exterior border area will now be covered by the border, The 
select bits operate as follows: 



RSEL 



NUMBER OF ROWS 



CSEl NUMBER OF COLUMNS 



'1A rows 

25 rows 



38 columns 
40 columns 



The RSEL bit is in register 17 ($11) and the CSEL bit is in register 22 ($16). 
Fo; standard display the larger display window is normally used, wile 
the smaller display window is normally Jsed in conjunction with scrolling. 

SCROLLING 

The display data may be scrolled up 1c one entire character space in 
both ths horizontal and vertical direction. When used in conJLrct'cn with 
1he smaller display window (above], scrolling can be used to create a 
smooth panning motion ot display data while uodcting the systom 
ivienory only when a new character row (or column) is required. Scroll- 
ing is also used to center a fixad display wvithin the display window. 



RITS 



RbGISTER 



FUNCTION 



X2,X1,X0 
Y2,YI,Y0 



22 <$lc) 
17 ($11) 



Horizontal Fusil ion 
Vertical Position 



LIGHT PEN 

The light pen inpu J latches the current screen position into a pair of 
registers (LPX,LPY) on a bw-going edge. The X position register 19 {$l3j 
wili contain the 8 M5B of the X position a I I he lime ul tmnsit'on. Since 
the X position is defined by a 512-state counter (9 bits) resolution to 2 
horizontal dols is provided. Similarly, the Y position is atched to its reg- 
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isler 20 (3 14) bur here 8 bits provide sirgfe raster resolution within the 
visible display, The light pen latch may be triggered only once per 
frame, and subsequent triggers within the same frcme will have no 
effect, ~heiefors, you must take several samples before turning the light 
pen to the screen (3 or more samples, average), depending upon the 
characteristic J of your light pen. 

RASTER REGISTER 

The raster register is a dual-function register. A read of the 'aster 
Agister IE ($12) returns the lower 8 bits of the current raster position 
(the MSB-RC8 is located In register 17 (SI It). The raster register nan he 
interrogated to implement dlsploy changes outside the visible arec to 
prevenl display flicker. The visible displcy wirdow is from raster 51 
through roster 251 <$033-$OFB). A write to the raster bits (incljding 
RC8) is latched for js* in un internal raster compare. When the current 
raster metcies the written value, the rcstc intcrrjpt latch is set. 



INTERRUPT REGISTER 

The interrupt register shows the status of the four sources of interrupt. 
An Interrupt latch in regisfpr 75 ($19) is set to "1" when an interrupt 
source has generateo an interrupt request. The four sources of mlerrupt 
are: 



LATCH 
BIT 



IRST 

IfWDC 

IMMC 

ILP 
IRQ 



ENABLE 
BIT 



EfiST 

EM DC 

EMMC 
ELP 



WHEN SET 



Set when (raster count) = (storec raster count) 
Set by MOB- DATA collision register (first collision only] 
Set by MOB- MOB collision -egisrer (first collision only) 
Set by negative transition of LP input (once pc- frame) 
Set high by latch set and enabled (invert of IRQ/ output) 



To enable en interrupt request to set the IRQ/ outpot to "0," the corre- 
spundhy interrupt enable bi- in register 26 ($1A) must be set to "1." 
Once an interrupt latch has been set, the latch may be cleared only by 
writing a J l" to the desired Intrh in the interrupt register. This feature 
aflaws selective handling of video interrupts without software required to 
"remember" active interrupts 
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DYNAMIC RAM REFRESH 

A dynamic ram refresh controller is built ; n to the 6566/6567 devices. 

= ive 8-bit row addresses are refreshed every' rosier line. This rate 
guarantees a maximum delay of 2.02 rrs botwccn the refresh of any 
single row address in a 128 ref-esh scheme. (The maximj-n delcy is 
3.66 ms in a 256 address refresh scheme.) This refresh is totally trans- 
parent to the system, s'nee The refresh ocrjjrs during Phase 1 of the 
system clock. The 6567 generates both RA5/ and CAS,' wnich ore nor- 
mally connected directly to the dynamic rams. RA5/ and CAS/ ore gen- 
erated for every Phase 2 and every video data access (inc uding refresh) 
so that external clock generation is not required. 



THEORY OF OPERATION 

SYSTEM INTERFACE 

The 6566/6567 video cunlruller devices inleratl with the system dulu 
bus in a special way, A 65X.X sys^m requires the system buses only 
during The Phase 2 (clock high) portion of the cycle, The 6566*'6567 de- 
vices too aavantcge of this teature by normally accessing system 
memory during the Phase 1 (c ock owl ptjrtiun of I ! its- cluck cycle. There- 
fore, operations such as character data fetches and memory 'efresh are 
totally ficnspaiert to the processor and do not reduce the processor 
throughput. The i/ideo chips provide the interface control signals re- 
quired to maintain this bus sharing. 

[he video devices provide the signal AfcC (address enable control) 
which is used to disable the processor adcress bus drivers allowing the 
video device to access the address bus. AEC is active low which permits 
diect curirectori to the AEC npul of I lie 65XX 'airily. The AEC signal is 
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normally activated during Phase I so that processor operation is not 
affected. Because of this qus "sharing," oil memory accesses must be 
completed in \i7 cycle. Since the video chips provide a l-Mhz clock 
(which must be used as system Phase 2), a mem cry cycle is 500 ns 
including address serup, data access and, data setup to the reading 
device. 

Certain operations of ths <S566/oo67 require data at a faster rate than 
available by reading only during the Phase 1 time; specifically, I lie uc- 
cess of character painters from the video -na1ri> and the fetch of MOB 
data. Therefore, the processor must be disabled and the Jutu accessed 
during the Phase 1 Hnc-k. This is accomplished via the BA (bus available) 
signal. Ths BA line Is rorma 1/ high but is brought low during Phase 1 to 
indicate that the video chip will require a Phase 2 data access. Three 
Phase-2 times are allowed after BA low for the processor to complete 
any current memory accesses. On the fourth Phase 2 after BA low, rhe 
AEC signal will remain ow during Phase 2 as the video chip fetches 
data. The BA line is norma I. y connected to the RDY input of a 65XX 
procesoor. The character pointer fetches occur every eighth raster line 
during the display window end require 40 consecutive Phase 2 accesses 
to fetch the video matrix pointers. The MOB data felches require -t- 
memory accesses as follows: 



PHASE 


DATA 


CONDITION 


1 


MOB Pointer 


Every raster 


2 


MOB Byle 1 


Each rosier while MOB is displayed 


1 


MOB Byte 2 


Each raster while AIOB is displayed 


2 


MOO Byte 3 


Each raster while MOB is displayed 



The MOD pointers are fetched every other Phase 1 at the end of euiii 
raster line. As required, the additional cycles are used for MOB data 
fetches. Again, all necesscry oua control is provided oy the 6566/6567 
devices. 



MEMORY INTERFACE 

The two versions of the video interface chip, 6566 and 6567, differ in 
address output configurations. The 6566 ha; thirteen fully decoded ad- 



APPEMDIX N 



449 



dresses for d reef correction to -he sys*enn address bus. The 6567 has 
mutiplexed addresses for direct connection to 64 K. dynamic RAMs. The 
least significant address bits, A06— AOQ, are present on A06— A00 while 
RA5/ is oroughf low, while the most signifkan- bits, AI3—A08, are pres- 
ent on A05-AO0 while CAS/ it bruuyhl low. The pins Al 1 -A07 on the 
6567 ore static oddress ou'puts "0 cllow direc" connection of these bits 
to a conventional 1 6K (2KX8) ROM. (The lower order addresses require 
external latching.) 

PROCESSOR INTERFACE 

Aside 'ran the soecial memory accesses described above, the 6566/ 
6567 registers car be cccessed similar to any onSer periphercl device. 
The following processor interface sign a s are provided: 

DATA BUS (DB7-DB0) 

The sight data bus pins are the bi-direc-ioncil date por, controlled by 
CS/, KW, and Phase 0. T he data bus can only be accessed while AEC 
end Phase ore high and CS/ is low. 

CHIP SELECT {CS/} 

The chip ssleet pin, CS,', is brougir low to enable access f o the device 
registers irt conjjn-tion with the address and RW pins, CS/ low is recog- 
nized only while AEC and Phase are high. 

READ/WRITE (R/W) 

The read/write input, R/W, is used to determine the di r ection of data 
Transfer on The dcra fcLS, in conjunction with CS/. When R/W is high -'"1") 
data is transferred from *he selected register *o the data bus ojtput. 
When R/W is low ("0") doty uresenled on the dutu bus pins is loaded 
into the selected register. 

ADDRESS BUS (A0.5-AOO) 

The lower six address pins, A5— AO, are bi-directional. During a pro- 
reS5or r=>ad nr write of the video device, these address pins are inputs. 
The data on the address inputs selects the register for read or write as 
defined in the register me p. 
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CLOCK OUT (PHO) 

The clock output. Phase C, is the 1-MHz clock used a* the oSXX pro- 
cessor Phase in, All system bus cctivity is referenced to tSls clock. The 
dock frequency is generated by dividing the 8-MHz video input clock by 
eight, 

INTERRUPTS (IRQ/) 

The interrupt output, IRQ/, is brought low when an ennbled source of 
interrupt occurs within the device. The IRQ/ output is open d-ain, requir- 
ing an external pull-up resistor, 



VIDEO INTERFACE 

The video output signal froin the 6566/6567 consists of two signals 

which must be externally mixed together. SYNC/LUM output contains all 
the video dale, including horizontal and vertical syncs, as well as the 
luminance information o' the video display. SYMC/LUM is open drain, 
requiring un external pull-up of 500 ohms. The COLOR ou'put rontnins 
all the chrominance information, including the color reference burst and 
the color of oil display data. The COLOR output is open source end 
should be terminated with 1000 ohms to ground. After appropriate mix 
ing of these two signals, the resulting signal can directly drive a video 
monitor or be fed to a modulator for use with o standard television. 



SUMMARY OF 6566/6567 BUS ACTIVITY 



AEC 


PHO 


CS/ 


R/W 


ACTION 








X 


X 


PHASE 1 FETCH, REFRESH 





1 


X 


X 


PHASE 2 FETCH (PROCESSOR OFF) 


1 





X 


X 


NO ACTION 


1 


1 








WRITE TO SELECTED REGISTfcR 


1 


1 





> 


READ FROM SELECTED REGISTER 


1 


1 


I 


X 


NO ACTION 
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PIN CONFIGURATION 



G8S 

DB4 
DEj 
DB 2 

DB-, 
DRo 
IRQ/ 

LP 
CSI 
FVW 

■(A 

Vm, 

COLOR 
SfLUM 

ft EC 

PH 

HASJ 

CASr 

Vsa 



1 


w 


10 


? 




m 








3 




38 


4 




37 


5 




36 


6 




35 


T 




34 








8 




33 


9 




32 


11 


6567 


,11 


11 




30 


12 




29 


11 




?H 








14 




27 


15 




ae 


16 




25 


17 




24 


IK 




iJ 


19 




22 








20 




21 



DB 7 
DB a 
DBg 
DB 1D 

DBn 

A i 

*3 
At 

*7 
A 5( A 13 1 

AiiAi a ; 

A 3 (A-,-|h 

A;(A, | 

A t (A S > 

*a< A 6> 

*11 

pur-j 
PHCL 



(Mult rJexeJ addresses in parentheses) 
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PIN CONFIGURATION 






O 




oa 9 


1 




3 


D3|, ' 


a 




39I 


DB 4 


3 




00 1 


nB :3 


4 




3/ 


DD 2 


B 




35 


DB 1 


6 




35 


DEj 


7 




34 










IRQ* 


S 




■Jd 


LF 


9 




32 






6566 




cw 


10 




Jl 


FWV 


11 




3: 


BA 


12 




Z3 


YflD 


13 




2B 


COLOR 


1J 




2? 


SLUM 


15 




23 


AEC 


16 




25 


PHj 


17 




21 


PHIN 


16 




23 


PHCO. 


19 




22 


Vs K 


20 




3 



v<x 



De 8 

Obi) 

db 10 

A |2 
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REGISTER MAP 










ADDRESS 


DB7 


DB6 


DBS 


DB4 


DB3 


DB2 


DB1 


DBO 


DESCRIPTION 




00 


!$O0) 


M0X7 


MQXfi 


M0X5 


M0X4 


M0X3 


MCX2 


M0X1 


AflOXO 


MOB X-positinn 




01 


:$od 


M0Y7 


A10Y6 


M0Y5 


M0Y4 


M0Y3 


W0Y2 


M0Y1 


MOYO 


AAOB Y-position 




02 


:$02> 


M1X7 


AMX6 


M1X5 


M"X4 


M1X3 


M1X2 


AM XI 


M1X0 


MOR 1 X-position 




03 


;$03i 


M1Y7 


AMY6 


M1Y5 


M1Y4 


M1Y3 


W1Y2 


A/IIY1 


M1Y0 


MOB 1 Y-position 




04 


:$04) 


M2X7 


M2X6 


M2XS 


M2X4 


M2X3 


M2X2 


M2X1 


AA2X0 


AAOB 7 X-position 




05 


;$os) 


M2Y7 


A12Y6 


M2Y5 


M2Y4 


M2Y3 


MSY2 


M2Y1 


M2Y0 


AAOB 2 Y-position 




06 


:$o« 


M3X7 


A13X6 


M3X5 


M3X4 


M3X3 


M3X2 


A*\3XT 


W3X0 


MOR 3 X-position 




07 


:$07) 


M3Y7 


A13Y6 


M3Y5 


M3Y4 


M3Y3 


M3Y2 


M3¥1 


M3Y0 


AAOB 3 Y-position 




OS 


;$os) 


M4X7 


AMX6 


M4X5 


M4-X4 


M4X3 


W4X2 


AW XI 


M4X0 


MUti 4 X-position 




09 


:$09) 


M4Y7 


A14Y6 


M4Y5 


M4Y4 


M4Y3 


M4Y2 


M4Y1 


M4Y0 


AAOO 4 Y-position 




10 


:$<yy 


MAX? 


A15X6 


495X5 


M5X4 


M.5X3 


M5X2 


M5X1 


W15X0 


MOB b X-position 




11 


:$ob) 


M5Y7 


t\\5Y6 


AA5Y5 


M5Y4 


M5Y3 


M5Y2 


M5V1 


M5Y0 


MOD 5 Y- position 




12 


:$oo 


MoX7 


MkKb 


M6X5 


MAX 4 


M6X3 


WfiX? 


M6X1 


McXO 


MOB 6 X-postion 




13 


;$od) 


MoY7 


A16Y6 


M6Y5 


M6Y4 


M6Y3 


W6Y2 


M6Y1 


M6Y0 


MOB 6 Y- position 




14 


r $OE) 


M7X7 


A*\7X6 


M7X5 


M7X4 


M7X3 


W7X2 


M7K1 


M7X0 


MOR 7 X-postion 




15 


'$OFl 


M7Y7 


A17Y6 


M7Y5 


M7Y4 


A47Y3 


M7Y2 


M7Y1 


MoYO 


MOB 7 Y-posilian 




16 


;$io) 


M7X8 


AA6X8 


M5X8 


M4X3 


M3X8 


M3X8 


M I KB 


MUX8 


MSB of X-position 




17 


'$n> 


RCS 


ECM 


Dwm 


DCN 


RSEL 


Y2 


Yl 


YO 


See text 




IS 


sr2) 


RC7 


RC6 


RC5 


RC4 


RC3 


kC2 


RC1 


RCD 


Raster register 




I 1 ? 


'$13) 


LPX3 


LPX7 


LPX6 


LPX5 


LPX4 


LPX3 


LPX2 


LPX1 


Light Pen X 




20 


SI A) 


IPY7 


LPY6 


IFY5 


LP/4 


LPY3 


LPY2 


LPYl 


L H Y (J 


Light Pen Y 




21 


SI 5) 


M7E 


M6E 


M5E 


M4E 


M3E 


W2E 


M1E 


MOE 


MOB Enuble 




22 


;si6) 


— 


— 


RfcS 


MCV, 


CStL 


JC2 


XI 


XU 


See text 




23 


$17) 


M7YE 


M6YE 


M5YE 


M4YE 


M3YE 


M2YE 


MIYE 


MOYE 


MOB Y-expand 





> 

"3 






24 ($"g; VM13 VM12 VMM VM10 CB13 CB12 CB11 

25 ($19] IRQ — — I LP IMMC IMBC IRST 

26 i$lA) — — ELP EMMC EMBC ERST 

27 i$1B; M7DP M6DP M5PP AMDP M3DP M2DP .Ml DP MOfJP 

28 (flQ M7MC MAMC M5MC M4MC M3MC M2MC M1MC MOMC 

29 f$lD) M7XE M6XE M5XE M4XE M3XE M2XE M1XE MDXF 

30 [$1E) M7M M6M M5M M4M M3M M2M M1M MOM 

31 ($1F) M7D M6D M5D M4D M3D M2D MID MOD 

32 ($20) — — EC3 IC2 EC1 ECO 

33 i$21) — — — BCC3 BOr? ^DCl BOCO 

34 ($22) — E?C3 B1C2 31C1 B1C0 

35 (-S23J — R2C3 B2C2 B2C1 B2CU 

36 ($24) — B3C3 B3C2 B3C1 B3C0 

37 ($25) — — — MMG3 MKA02 AAMD1 MMOO 

38 ($26) MM13 MM12 MM1 1 MM10 

39 ($27) — — M0C3 M0C2 MOCI MOCO 

40 ($28) — — MC3 WC2 Ml CI Ml CO 

41 ($29) — — — M2C3 M2C2 M2C1 M2C0 

42 ($2A1 - M3C3 M3C2 M3C1 M3C0 

43 ($2B) — — M4C3 M4C2 M4CI M4C0 

44 ($2CJ — — — — M5C3 M5C2 M5CT M5C0 

45 ($2D] — — — M6C3 M6C2 M6C1 M6C0 

46 ($2E) — — M7C3 M7C2 M7C1 M7C0 



Memory Pointers 
Interrupt Register 
Enable Interrupt 
MOB-DATA Priority 
MOB Multicolor 5el 
MOB X-expcind 
MOB-MOB Collision 
W.OB-LWA Collision 
Exterior Color 
Bltgd #0 Color 
Bkyd #1 Color 
Bltgd #2 Color 
Bkyd #3 Color 
MOB Multicolor #0 
MOB Multicolor #1 
MOB Color 
MOB 1 Color 
MOB 2 Color 
MOB 3 Color 
MOB 4 Color 
MOB 5 Color 
MOB. 6 Color 
MOB 7 Color 



NOTE: fi, dash irdlea'es a no connect. All no connects ate read 



COLOR CODES 



D4 


D3 


Dl 


DO 


HEX 


DEC 


COLOR 














Q 





BLACK 











1 


1 


1 


WHITE 





o 


1 





2 


2 


RED 








I 


1 


3 


3 


CYAN 





1 








4 


A 


PURPLE 





1 





I 


5 


5 


GREEN 





1 


1 





6 


6 


BLUE 





] 


1 


1 


7 


7 


VELLOW 













a 


3 


ORANGE 










1 


s 


9 


BROWN 







1 





A 


10 


LT RED 







1 


1 


B 


11 


DARK GREY 




1 








C 


12 


MED GREY 




1 





1 


D 


13 


LT GREEN 


1 


1 


1 





E 


14 


LT BLUE 


1 

1 


1 


1 


1 


h 


15 


LI GkfcY 
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6581 SOUND INTERFACE DEVICE (SID) 
CHIP SPECIFICATIONS 

CONCEPT 

The 6581 Sound Interface Device (SID) Is a single-chip.. 3-voice elec- 
tronic music synthesizer/ sound effects generator compatible with the 
65XX and similar microprocesso' families. SID provides wide-range, 
high-.'esol ution control of pitch (frequency), tone color (harmonic con- 
tent], and dynamics [volume). Specialized control circuitry minimizes 
sotlware overhead, tacilitating use in arcade/hams videc games and 
low-cost musical Instruments. 

FEATURES 

• 3 TONE OSCILLATORS 

Rnnrje- 0-4 kHz 

• 4 WAVEFORMS PER OSCILLATOR 

Triangle, Sawtooth, 
Variable- Pulse, Noise 

• 3 AMPLITUDE MODULATORS 

Range: 48 dS 

• 3 ENVELOPE GENERATORS 

Exponential response 
Attack Rate: 2 ms-fl s 
Decay Rata: 6 ms— 24 s 
Sustain Level; 0— peak volume 
Release Kate: 6 ms- 24 s 

• OSCILLATOR SYNCHRONIZATION 

• RING MODULATION 
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• PROGRAMMABLE FILTER 

Cutoff range: 30 Hz- 12 kHz 
12 dB^octave Relief f 
Low pass, Bund puss. 
High pass, Notch outputs 
Vuricble ReSondrtce 

• MASTER VOLUME CONTROL 

• 2 Aj'D POT INTERFACES 

• RANDOM NUMBER/MODULATION GENERATOR 

• EXTERNAL AUDIO INPUT 
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DESCRIPTION 

The 658) consists of three synthesizer 'Voices" which can be used 
independently or in conjunction with each other [or external audio 
sources) to create complex sounds, Each voice consists of a Tare 
Oscillator/Wnvpff rm Generntor, an Envelope Generator and an 
Amplitude Modulator. The Tone Os='l ator controls the pitch of the voice 
over a wide range. The Oscillator produces four waveforms at the 
Selected f'equency, with the unique harmonic content of each waveform 
providing simple control of tone color. The volume dynamics of the oscil- 
lator are controlled by the Amplitude Modulator uncer the direction of 
the Envelope Gprnsrator When triggered, the Envelope Generator 
creates an amplitude envelope with programmable rates of increasing 
and decreasing volume. In addit'on to the Three voices, a programm- 
able Filter is provided for generating complex, dynamic tone colors vie 
subtractlve synthesis. 

SID allows the microprocessor to read the changing output of the thirc 
Oscillator and third Envelope Generator. These ouipim can he used as c 
source of modulation information for creating vibrato, frequency/filter 

sweeps and similar effects. The third oscillator can also act as a random 
number generator for games. Two J\fD converters are provided for nter- 
facing SID w'th potemiomeTers, These can be used for "paddles" in c 

garre environment or as front panel controls in c music Synthesizer. SID 
can process external uudio signals, ullowiny multiple SID chips 1u be 
daisy-chained or mixed in complex polyphonic systems. 

SID CONTROL REGISTERS 

There are 29 eight-bit registers in SID which control the generation of 
sound. These registers are either WRITE-tmly or 3EAD-unly and are listed 
below in Table I , 
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SID REGISTER DESCRIPTION 

VOICE 1 

FREQ I O. FREQ HI (Registers 00,01) 

Together these registers form a 1 6— bit number which linearly controls 
the frequency of Oscil aTor 1. The frequency is determined by the follow- 
ing cqua'ion: 

Fou. = [F n * W 167772 16) Hz 

Where F r is the 16-oit number in the Frequency registers and F C |k is the 
system clock applied fo the <p2 input (pin 61. For a standard 1.0-MHz 
clock, the frequency is given by: 

F*ut = ( p n Y 0.0596O4M5) Hz 

A complete table at values for gene'Oting 8 octaves of the equally 
tempered musical Scale with Concert A (440 Hi] tuning is provided in 
Appendix E. It should be noted that the frequency resolution of SID is 
sufficient for any tuning scale and allows sweeping from note to note 
(portamen"o) with nc discernoble frequency steps, 

PW LO/PW HI (Registers 02,03) 

Together these registers form a 12-bit number (bits 4—7 of PW HI are 
not used) which linear y contrcls llie Pulse Wid li (duly cycle) of ihe Pulse 
waveform or Oscillator 1. The pulse width is determined by the follow- 
irg equation; 

PWout = <PW n /40.95) % 

Where PWn 's the 12-fcit number in the Pulse Width registers. 

The pulse width resoluticr allows the width 'o be smoothly swept with 
no discernable stepping. Note that the Pulse waveform on Oscillator 
must be selected in order for The Pulse Width registers to nave any au- 
dible effect. A value of or 4095 ($FF) in the Pulse Width regis-ers will 
prod jcs a constant DC output, while ci va ue of 2043 ($800) will produce 
u square wave. 



462 APPENDIX O 



CONTROL REGISTER (Register 04) 

This register eorrains eight contra bits which select various options on 

Oscillate* 1 , 

GATE (Bit 0); The GATE bit control; the Envelope Generator for Voice 
I. When this bit is set to a one, the Envelope Generator is Gated 
tt-iggered) and the ATTACK/DECAY; SUSTAIN cyc | e ; 5 initiated. When the 
b't is reset ta a zero, the RELEASE cycle begins. The Envelope Generator 
controls the amplitude of Oscillator 1 appearing at the audio output, 
therefore, the GATE bit must be set {along with suitable envelope pa- 
rameters) "or the selected output of Oscllator 1 to be audible. A dc 
laied discussion of the Envelope Generator car be found a - the end of 
ihis Appendix. 

SYNC (Bit I): The SYNC bit, when set to a one, synchronizes the 
fundamental frequency of Oscillator 1 with the fundamental frequency 
of Osci lator 3, producing "hard Sync" effects, 

Varying the frequency of Oscillator 1 with respect to Oseillcror 3 pro- 
duces a wide range of complex fiurmoriic slruclures Irani Vcice 1 ut the 
frequency of Oscillator 3, In order for sync to occur, Oscillator 3 must be 
set lo some frequency older than ^ero bul preferably lower than the 
frequency of Oscillator 1. No other parameters of Voice 3 lave any 
effect on sync 

RING MOD (Bit 2): The RING MOD bit, when set to a one, replaces 
the Triangle waveform output of Oscillator 1 with a "Ring Modulated" 
combination of Oscillators end 3. Varying the frequency of Oscillator 1 
with respec" to Oscilla*or 3 produces a wide rcnge of non-hennonic. 
overtone structures for creating bell or gong sounds and far sp=c : al ef- 
fects. In order for ring modulation -o be aucible, rhe Triangle waveform 
of Oscillator 1 must dr selected nnd Oscillator 3 must be set to some 
frequency other than zero, No other parameters of Voice 3 have any 
effect on ring modula*ion. 

TEST (Bit 3); The TEST bit, when set *o a one, resets and locks Oscil- 
lator ] or zero unril the TEST bit is cleared. The Noise waveform output 
of Oscillator 1 is also 'eset and the Pulse waveform output is held at a 
DC level, Normally this bif is used for testing purposes, however, it can 
be used to synchronize Oscillator 1 to externa! events, allowing the 
generation of highly complex wcveforms under real-time software con- 
trol. 
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(Bit 4): When set to a one, the Trinngle waveform output of Oscillator 
1 i5 selected. The Triang'e waveform is law in harmonics and has a 
mellow, flute-like quality. 

(Bit 5}: When set to o one, the Sawtooth waveform output of Oscil- 
lator 1 is selected. The Sawtooth waveform is rich in even and odd 
harmonics end has o bright, ora3sy quality, 

(Bit 6); When set to a one, the Pulse waveform output of Oscillator 1 
is selected. The harmoni: content of this waveform can be adjusted by 
the Puke Width registers, producing lone qualities ranging from a 
bright , hollow square wave to a no sal, reedy pulse. Sweeping the pulse 
width in real-time produces a dynamic "phasing" effect which adds a 
sense of motion to the sound, Rapidly jumoing between different pulse 
widths can produce interesting harmonic sequences. 

NOISE (Bit 7J: When set to a one, the Noise output waveform of 
Oscillata r 1 is selected. This output Is a random signal which changes at 
the frequency of Oscillator 1. The sound quality can be varied from a 
low rumbling to hissing white noise via the Oscillator 1 Frequency regis- 
ters. Noise is useful in creating explosions, gunshots, jet engines, wind, 
surf and other unpitched sounds, as well cs snare drums and cymbals. 

Sweeping the oscillator frequency with Noise selected produces a dra- 
matic rushing eFFect. 

One of the output lA'aveforms must be Selected for Oscillator 1 to be 
audible, however, it is NOT necessary to de-selec" waveforms to silence 
thp n.itput nf Voire* 1. The amplitude of Voice 1 al the final output is a 
function of the Envelope Generator only. 



NOIE: The oscillator output waveforms arc WOT odcitTvc. If marc than one output 
waveform is selected simultaneously, the result will be a logical ANDina of the 
waveforms. Athioua,h this technique can be used to generate acditicnal waveforms 
beyord "he iour listed obeve, it must be msec with care. If any other waveform is 
selected while Noise is on, the Noise outpu" can "lock up.'' If this occurs, the Noise 
DUTpul will remain silent until reset Ly the TEST bit 01 by bringing RES (pin 5) luw_ 
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ATTACK/DECAY (Register 05) 

Bits 4 7 of this register ;ATK0-ATK3) select 1 of I 6 ATTACK rotes for 
The Voice 1 Envelope Generator. The ATTACK rate determines how 
rapidly the output cf Voice I rises frcm iero to peak amplitude when the 
Envelope Generator is Gated. The 16 ATTACK rates are listed in Table 2. 

Bits 0-3 (DCV0-DCY3) select 1 of 16 DECAY rates *ar the Envelope 
Generator. The DECAY cycle fellows the ATTACK cycle and the DECAY 
rate determines how rapidly the outpu* falls from the peak amplitude to 
the selected SUSTAIN evd, The 16 DECAY rates a-e listed in Tcblc 2. 

SUSTAIN/RELEASE [Register 06) 

Bits 4- 7 cf this register (5TN0-5TN3) select 1 of 1 6 SUSTAIN lew-Is for 
the Envelope Generator. The SUSTAIN cycle fol ows the DECAY cycle and 
the output of Voice 1 will remain at the se ected SUSTAIN ^mplilude as 
long as the Gate bit remains set. The SUSTAIN levels range from zero to 
peak ampliTiide in 16 linear steps, with a SUSTAIN value of selecting 
sera amplitude and a SUSTAIN value of 15 ($F) selecting the penk 
ampl'tude. A SUSTAIN value af 8 would cause Voice I to SUSTAIN at an 
amplitude one-half the peak amplitude reached by the ATTACK cycle. 

Bits- 0-3 ;RLS0-RLS3) sebct 1 of 16 RELEASE rates for the Envelope 
Generator. The RtLEASE cycle follows the SUSTAIN cycle when The Gate 
bit is reset to mm. At this fine, the output of Voice 1 will fall from *he 
SUSTAIN amplitude to zero Amplitude at the selected RELEASE rate. The 
16 RELEASE rates are identical to the DECAY rates. 



MOTE; The cycling of the Envelops Generator con be altered at any poirt win the Gnte 
bit. The Envelope Generator com be Gated and Relecsed without restriction for 
BMjmpe, if the Gate bit Is reset befaic- the envelops hat finished the AfACK cycle, 
the RELEASE eye e mill immediately begin, starting from *riar«ver amplitude had 
been reacted. If the envelope s ihen Gated again {before the 5EtEA.SE cycle hoe 
reached zero umpliiude), another- ATTACK cycle will beg n, starting from whatever 
amplitude hod been readied. Ths technique can be caed to generate com ilex 
amplitude envelopes via reel-lime suftwuie central, 



APPENDIX O 465 





Table 2, Envelope Rates 


VALUE 


ATTACK RATE 


DE CAW RELEASE RATE 


DEC (HEX) 


(Timc-.'Cyde) 


(Time/Cycle) 


(0) 


7 ms 


6 ms 


1 (1) 


8 ms 


24 ms 


2 (2) 


16 mi 


48 ms 


3 (3) 


24 ri5 


72 ms 


4 (4) 


38 ms 


114 ms 


5 (5) 


54 ns 


163 ms 


6 (6) 


68 ms 


204 ms 


7 (7) 


80 ms 


240 nrs 


8 18) 


100 mil 


300 ms 


9 \9) 


250 ms 


750 ms 


10 (A) 


500 ms 


1.5 5 


11 (B) 


800 ms 


2.4 s 


1 2 CC) 


1 5 


3 = 


13 (D) 


3 s 


9 s 


14 :e> 


5 s 


15 ; 


15 [R 


8 s 


?i * 



NOTE Envelope rotes are based on a I.Q-AlHi <£2 clock. For other ip2 'rsquercies, 
multiply 1he given rate by l l*Hz/^, The rotes refe- re the onount of time per cycle. 
|-or example, gi/en an ATTACK value d- 2, "he ATTACK, cycle would tcke 16 ms to rise 
tmm 7prn trt penk nrrtpliNirip. Trip DFf AY/RFI FASF 'ntf><, refftr fr. *hfi amount n+ timp 
Ih^se (*yH»s would Inltft to frill ffrim psak amplitude: tft Terr*. 



VOICE 2 

Registers 07-$QD control Voice 2 and are functionally identical to ret 
■Sters. 00 — 06 with these exceptions: 



1) When selected, SYNC synchronizes Oscillator 2 with CKcillntor 1. 

2) When bettted, RING MOD replaces the Triangle output f Qscil 
later 2 with the ring modulated combination of Olri IrttorS 7 find 1 . 



444 



APPENDIX O 



VOICE 3 

Registers $0E— $14 control Voice 3 and a'e ■functionally identical to 
registers 00—06 with these exceations; 

3) When selected, SYNC synchronises Oscillator 3 wild Oscillator 2. 
2) When selected, RING MOD replaces the Triangle output of Oscil- 
lator 3 with the ring modulated combination of Osci lators 3 and 2. 

Typical operation of a voice consists of selecting the desired parame- 
ters: frequency, waveform, effects (SYNC, RING MOD) and envelope 
rates, then gating the voice whenever the sound Is desired. The sound 
con be sustained for cry length of time and terminated by c earing the 
Gate bit. Each voice can be used separately, with independent parame- 
ters and gating, or in unison to create a single, powerful voice. When 
used in unison, a slight detuning of each oscillator or tuning to musical 
intervals creates a rich, animated sound. 

FILTER 

FC tO/FG HI (Registers $T5 f S16) 

Together fiese registers form an Tl-bit number tbits 3—7 of FC LO ore 
net used} which linearly controls the Cutoff (or Center) Frequency of the 
programmable Filter. The approximate Cutoff Frequency ranges from 30 
Hi to 12 KHz. 

RES/FIU (Register $17) 

Bits A 7 of this register (RES0-RES3) control the resonance of the 
filter. Resonance is a peaking effecl which emphasizes frequency com- 
ponents at the Cutoff Freeueney of the Filter, causing a sharper sounc . 
There are 16 resonance settirgs ranging linearly from no resonance (0) 
to maximum resonence (15 or $F). Bits 0-3 determine whin^i signals will 
be rouled through the Filter; 

FIIT 1 (iil 0)i When set to a Tern, Voice 1 appears directly at the 
audio output and the Filter ha? no effect on it. When set to e one, Voice 
I will be processed through the Filter and the harmonic content f Voice 

1 will be altered according to the selected Filter parameters. 
Fill 2 {Bit 1): Some as bit for Voice 2. 
Fill 3 (Bit 1): Some as bit for Voice 3. 
FILTEX (Bit 3): Sarre cs bit for Exrernal audio input (pin 26). 
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MODE/VOL [Register $ IS) 

Bits 4— 7 of this register select various Filtc mode and oulput options; 

LP (Bit 4): When set to a one, the Low-Pass output of The Filter is 
selected and sent to the audio output. For a given Filter input signal, oil 
frequency components below line Filter Cutoff Frequency ore passed 
unaltered, while all frequency components cbove the Cutoff are at- 
tenuated a- a rate of 12 dB/Oduve. The Low-Pass mode prooi'Ces full- 
bodied sounds. 

BP {Bit 5\: Surne as bit 4 for the Bandpass output. All frequency 
comoonents above and below the Cutoff are attenuated at a rate of 6 
dB/Octave. The Bundrjass mode produces thin, open sounds. 

HP (Bit 6): Same os bit 4 for the High-Pass outovt. All frequency 
components above the Cutoff are passed unaltered, whilf? u'l frequency 
components helrw the Cutoff are citteruated at a rate of 12 dBVQctave, 
The High-Pass mode produces tinny, buzzy sounds. 

3 OFF [Bit 7): When set to o one, the ojtpul of Voice 3 is disconnected 
from the direct audio path. SeftViO Voice 3 to bypass the Filter (FlLT 3 = 
0) and setting 3 OFF to a nne prevents Voice 3 -rem reaching the audio 
outout. This allows Voice 3 to oe used for modulation purposes without 
any uncesirable outpjt. 



NOTE: The flFer uutjirt irodes ARE additve and imultiple Titer modes may be 
selected siiinJlurisuusly, Fur example, both IP aid HP modes ten Je selected Ic 
produce a Notch (or Bond Reject) Filter response. In order for the Filter la have any 
audible effect, aT least one Fifty * output must bg selected and at Iea5 _ one Voice musl 
be r cuted -rirough ihe Filter. The Flrer Is, perhaps, the mes* importers element in SID 
os It allows the senerailor of complex Tore colors via jubiracti/e syrrhesls (the c llrer 
ii used to eliminate specific frequency components from a larmonically rich inpji 
signal). Ihe best results ere achieved 3y varying the Lutoff Freguerey in real-fine. 



Bits 0-3 (VOLO VOL3) select 1 of 16 overall Volume levels -or the 
final composite audio output. The outpul volume levels range *rom no 
output (0) to maximum volume 05 or $F) in 16 linear steps. This control 
can be used os □ static volume control for balancing levels in multi-chip 
systems or for creating dynamic volume effects, such as Tremolo. Some 
voume level o r her than zero must be selectsd in order for SID to pro- 
duce any sound. 
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MISCELLANEOUS 

POTX (Register SI 9) 

This register allows the microprocessor to read the position of the 
potentiometer tied to POTX (pin 24), with values ranging from ot 
minimum resistance, to 255 ($FF) at maximum resistance. The value is 
always valid and Is updated every 512 <j>2 clock cycles. See rhe Pin 
Description section for information on pot and capacitor values. 

POTV (Register $1A) 

Same as POTX for the pot -ied to POTY (pin 23). 

OSC 3 RANDOM [Register $IB) 

This register allows the microprocessor to read the upper 8 output bi"s 
of Oscillator 3. The character of the numbers generated is directly re- 
lated to the waveform selected. If the Sawtooth waveform of Oscillator 
3 is selected, this register will present a series of lumbers incrementing 
from *o 255 (SFF) at a rate determined by the frequency of O&dllator 
3. If the Triangle waveform is selected, the output will increment from 
up to 255, then decrement down to 0. If the Pulse waveform is selected, 
the output will jump between and 255. Selecting the Noise wavefo'm 
will produce a series of rcindcn numbers, therefore, this register can be 
used os a random number generator for games, There art numerous 
timing and sequencing applications for the OSC 3 reg^ste', however, the 
chief function is probably that of a modulation generate. Ths numbers 
generated by this register can be added, via software, to the Osdlla T or 
or F'ltcr Frequency 'egisters or the Pulse VVldtn registers in real-time. 
Many dynamic effects can be generated in this manner, Siren-tike 
sounds can be created by adding the OSC 3 Sawtooth output +o the 
frequency control of another oscil ator, Synthesizer "Sample and Hold" 
effects can be produced by edding the OSC 3 Noise output to the Filter 
Frequency control registers, Vibrato can be produced by setting Oscil- 
lator 3 to a frequency around 7 H7 ond ndHing the OSC. 3 Triangle 
output (with proper scalincj) to the Frequency control of another oscil- 
lator. An unlimited range of effects ore available by altering the fre- 
quency of Oscillator 3 and scaling the OSC 3 output. Normally, when 
Oscillator 3 is used for modulation, ths audio output of Voice 3 should 
be eliminated (3 OFF - 1), 
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ENV 3 (Register SIC) 

Same as OSC 3, out this register allows the microprocessor to read 
the output of the Voice j tnvelope Generator. This output con be added 
to t-15 niter Frequency to produce harmonic envelopes, WAH-V/AH, and 
sim l«r effects. "Phaser" sounds can be created by adding this output to 
the frequency control register? of an oscillator. The Voice 3 Envelope 
Generator must be Gated in order to produce any output from this regis- 
ter. The OSC 3 register, huwevei, u'wLiys reflects the changing output of 
the oscillator and is not attected in any way by the Envelope Generator. 



SID PIN DESCRIPTION 

CAP1A,CAP1B, (Pins 1,2)/ CAP2A,CAP2B (Pins 3,4) 

These pins are used to connect the two integrating capacitors re- 
quired by the programmable Fil-er. CI connects between pins 1 anc 2, 
C2 between piis 3 and 4. Both capacitors should be the same value. 
Normal operation of the Filter over the audio range (approximately 30 
Hz "2 kHz) is accomplished with a value of 2200 pF for Cl and C2. 
Polystyrene capacito's are preferred and in complex polyphonic sys- 
tems, where many SID chips most trcck each other, matched capacitors 
are recommended. 

The frequency range ot the Filter cot be tailored to specific applica- 
tions by the choice of capacitor values. Tor example, a low-cost game 
mcy not require full high-frequency response. In this case, larger vcJue: 
for Cl and C2 could be chosen to provide rr.ore control over the bass 
frequencies of the Filter. The rraximum Cutoff Frequency of the Filter is 
given by: 

FCW = 2.6E 5/C 

Where C is the capacitor value. The range of the Filter extends 9 octaves 
below ihe maximum Cutoff Frequency. 

RES (Pin 5) 

This TTL-evel input is 1he reset control for SID. Wien brought low for 
at least ten cfr2 cycles, all internal registers are rese" to zero and the 
audio output h silenced. This pin is normally connected to the reset line 
of the microprocessor or a power-on-clear e'reuit. 
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<f>2 (Pin 6} 

This TTL-level input is the master clock for SID. All oscillator frequen- 
cies and envelope rates are referenced to this clock. (j>2 also controls 
data trans-firs between SID and the microprocessor. Data can only be 
transferred when i>2 is high. Essentially, <£2 acts as a high-active chip 
select as far as data transfers are concerned. This pin is normally con- 
nected to the system clock, with a nominal operating frequency of 1.0 
MHz, 

R/W (Pin 7) 

This TTL-level input controls the direction cif dntn transfers between 
SID and the microprocessor. If the chip select conditions have been met, 
a high on this line allows the microprocessor to Read data from the 
selected SID register and a low allows the microprocessor to Wife data 
into the selected SID register. This pin is normally connected to the sys- 
tem Read'Writc line. 

CS [Pin 8) 

This TTL-level input is a low active chip select which controls daro 
transfers between SID and the microprocessor. CS must be low for any 
transfer. A Read from rhe selected SJD register can only occur if CS ts 
law, $2 is high and R/W is high. A Write to ihe selected SID register can 
only occur if CS is low, 02 is high and R/W is low. This pin is normally 
eonnectec to address decoding circuitry, allowing SID -o reside in the 
memory map of a system. 

AD-A4 (Pins 9-1 J) 

These TTL-level inputs are j;ed to select one of the 2° SIU registers. 
Although enough addresses ere provided to select I of 32 registers, the 
remcjiriing three register locations are not used. A VAite to any of these 
th'ee locations is ignored and a R=ad returns invalid data. These pins 
are normally connected to the corresponding address lines of the mi- 
croprocessor so that SID may be addressed in the same morner as 
memory. 

6ND (Pin 14) 

For best results, the ground line berwsen SID and the power supply 
should be separate from ground lines to other digital circuitry. This will 
minimise digital noise at the audio output. 
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D0-D7 (Pins 15-22) 

These bidirectional lines are used to iransfei data between SID and 
the microprocessor. They are TTL compatible in the input mode and cc- 
pable of driving 2 TTL loads in the output mode. The date buffe-s ore 

usually in the high-impedance off stole. During a W-ite operation, the 
data buffers remain in the off (input] stale and (he microprocessor 
supplies data to SID ever these lines. Durng a Reed operation, the data 
buffers turn or and SID supplies data to the microprocessor over these 
lines. The pins are normally connected to the corresponding data lines cf 
the microprocessor. 

POTX,POTY [Pins 24,23) 

These r>ins ere rputs to the A/D converters used to digitize the posi- 
tion of pctenticmerer3. The conversion process s based oi the *i"ne con- 
stant of □ capacitor tied from the POT pin to ground, charged by a 
pctentiornccr *icd ; fom the POT pin to +5 volts. The component values 
ere determined by: 

RC = 4.7E-4 

Wnere R is the maximum resistance of the pot and C is the capacitor. 

The 'arger the capacitor, the smaller the POT value jitter. The recom- 
mended values for R and C ere 470 kil and 1000 pF. Note that a 
separate po" and cop are required for each POT pin. 

V cc £Pln 25) 

As with the GND line, a separate +5 VDC line should be run between 
SID Vcc and the powe' supply in order to minimize noise. A byposs 
capacitor should be located close to the pin. 

EXT IN (Pin 26} 

This tnuloy inpul allows external axdij signals to oe mixed with the 
audio output of SID cr processed through the Filter. Typical sources in- 
clude voice, guitar, and organ. The Input impedance of this pin is on the 
order of ino Icfl. Any signal applied directly to the pin should ride at a 
DC level of 6 volts and should not exceed 3 vclts p p. In order to pre- 
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vent any interference caused by DC level deferences, external signals 
should be AC-coupled to EXT IN by an e e-ctrolytic capacitor in ihc 1 10 
i«.F range. As the direct audio pafh (FILTEX=0) has unity gain, EXT IN 
can be used to m* outputs of many SID chips by daisy-chaining. The 
number of chips tn at can be chaned in this manner is determined by the 
amount of noise and distortion allowable at the final output. Note that 
the output Volume control will affect nol only I he ihree SID voices, but 
nlso any pxterncil inputs 

AUDIO OUT (Pin 27) 

This open-Source buffet is llie fnul audio output of SID. composed of 
the three SID voice;, the Kilter and any external input. The output level is 
set by the output Volume control and reaches a maximum of 2 volts p-p 
ot a DC level o~ 6 volts. A source resistor from AUD'O OUT to ground is 
required fcr prope" operation. The recommended resistance is 1 ki.1 for 
□ standnrri output impedance. 

As -he output of SID rides ot a 6-volt DC level, r should be AC- 
coupleri to nny nudio amplifier with an electrolytic capacitor in the I- 10 
;U,F range. 

V DD (Pin 2B) 

As with V cc , □ separate + 1 2 VDC line should he run to SID V DD ond o 
bypass ccpocito' should be used, 

6581 SID CHARACTERISTICS 

ABSOLUTE MAXIMUM RATINGS 



RATING 


SYMBOL 


VALUE 


UNITS 


Supply Vhltoge 


v CD 


-0.3 to +17 


VDC 


Supply Voltage 


v cc 


-0.3 to +7 


VDC 


Input Voltage (analog) 


V i(ia 


-0.3 to +17 


VDC 


Input Voltage (digital) 


Vine 


-0.3 to +7 


VDC 


Ope r ating Temperatu'e 


Ta 


to +70 


°c 


Storage Ternpercttur* 


faTO 


—55 to +150 


U C 
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ELECTRICAL CHARACTERISTICS [V DD =12 VDC±5%, V cc = 5 VDC±5%, T A =0 to 70 = C) 



CHARACTERISTIC 


SYMBOL 


WIN 


TYP 


IM.X 


UNITS 


Input High Vnltngp (RES, tf*2, R/W, C$, 
Input Low Voltage A0-A4, D0-D7) 




2 
0.3 





Vcc 

0.B 


VDC 
VDC 


Inpu* Leakage Current (RES, ^2, R/W, CS, 

A0-A4; V ta =0-5 VDC) 
Three-Side (OH) (DC- D/; V cc = max) 


'in 








2.5 

10 




Input Leakage Current V in =0. 4-2.4 VDC 












Output High Voltage (DO- 07; V cc = min, 

1 oad -200 jttA) 


Von 


2.4 


— 


V^-0.7 


VDC 


Output .ow Voltage (DO— D7; V cc = max, 

1 ,oad = 3.2 rnA) 


Vol 


CND 


— 


0.4 


VDC 


Output High Current (D0-D7; Sourcing, 

V OH = 2.4 VDC) 


'oh 


200 


— 


— 


(jiA 



z 
x 



Output Low Current (DO — D7; Sinking, 

V 0L =0.4 VDC) 


l L 


3,2 


— 


— 


rriA 


Input Capacitance (RfS, #2, R/W, Co, 

A0-A4, D0-D7) 


c tn 


— 


— 


10 


PF 


Pot Trigger Voltage (POTX, POTY) 


V PO t 


— 


V cc /2 


— 


VDC 


Put Sink Current I'POTX, POTY) 


'pot 


500 


— 


— 


fiA 


Inpu 4 Impedance (EXT IN) 


R in 


100 


150 


— 


kn 


Audio Input Voltage (EXT IN) 


V ln 


5.7 


6 
0,5 


6.3 
3 


VDC 
VAC 


Audio Output Voltage (AUDIO OUT; 1 kfl 

lood, vo urne - rrax) 
Ore Voice or: 
All Voices on; 


v out 


5.7 
0.4 

1.0 


6 
0.5 
1.5 


6.3 
0.6 
2.0 


VDC 
VAC 
VAC 


Power Supply Current Nod) 'do 


— 


20 


25 


mA 


Power Supply Current (V cc ) l cc 


— 


70 


100 


mA 


Power Dissipation (Total) P D 


— 


600 


1000 


mW 
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6581 SID TIMING 



^ 



■T tt - 



/ 



\ 



XXAa 



^V^\ 



B c -0 ; 



■«: 



x 



'oh— r 



'Tacc i3 measure:) from IHe latest ooeurrlig at a-,, CS, * -Aj. 



READ CYCLE 



\_ 



JC 



SYMBOL 


NAME 


MIN 


TYP 


MAX 


UNITS 


Tc/c 1 


Clock Cycle Tine 


1 


— 


20 


fix 


T- ! 


Clock High Pulse Width 


450 


500 


10,000 


ns 


T R J F 


Clock Rise/Fall Time 


— 


— 


25 


ns 


T=is 


Read SeT-Up Time 





— 


— 


ns 


T HH 


Read Hold Time 





— 


— 


ns 


T,\cc 


ACC98S Tim© 


— 


— 


300 


ns 


Tah 


Address Hold Time 


10 


— 


— 


ns 


TcH 


Chip Select Hold Time 





— 


— 


nj 


^BH 


Data Hold Time 


20 


— 


— 


ns 
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is rreasuf-ed from the tel?st occurring of ^ C§ R/w. 



WRITE CYCLE 



SYMBOL 


NAME 


MIN 


TYF 


MAX 


UNITS 


T w 


Wife Pulse Width 


300 


— 


— 


ns 


Twh 


Vtfite Hold Time 





— 


— 


ns 


^aws 


Address Set-up Tine 





— 


— 


ns 


Tah 


Address Hold Time 


10 


— 


— 


rs 


T C h 


Chip Select Hold Time 





— 


— 


ns 


Tvd 


Valid Data 


80 


— 


— 


ns 


Tdh 


0a1o Hold Time 


10 


— 


— 


ns 
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EQUAL-TEMPERED MUSICAL SCALE VALUES 

T'ie tab e in Appendx E I its the numerical values which must be 
stored in the SID Oscillator frequency contru registers tu produce I lie 
no+es ct -he equal-tempered musical scale. The equal-tempered scale 
consists of or octave containing 12 ser'iitsnes (roles); C,DiE,F,G,A,B 
and C#,D#,F# ,G#,A#. The frequency of each semitone is exactly the 
12'h rout 01 2 [ v 2) limes 'lie frequency of the pievious semitone. The 
table is based on a d>2 clock of 1,02 MHz. Refer to the equation given in 
the Register Descr jjlion fur use of other muster clock frequencies. The 
scale selected is concert pitch, in whici A-4 = 440 H2. Transpositions of 
this scale and scales other than the equal-tempered scale ore also pos- 
sible. 

Althccgh the table in Appendix E provides a simple and quick method 
for generating the eqLol-tempered scale, it is very memory inefficient as 
it requires 192 bytes for the taole atone. Memory efficiency cor be im- 
proved by determining the rote value algorrhmicaliy. Using the fact thnt 
each note in an octave is exactly half the frequency of that note ir the 
next octnve, the note look-up table ran he reduced from 96 ent'ies to I 2 
entries, as there are 12 notes per octave. If the 12 entries (24 bytes) 
consist of thp 1 fi-h't valups for 4 he eighth octave (C-7 through B-7), then 
notes in lower octaves can be derived by choosing the appropriate note 
in the eigh-h octave and div ding the 16-bit value by two for each octave 
of difference, As division by two is nothing more tbar a right shi-t of the 
value, the calculation can easily be accomplished by a sirnpe software 
routine. Although note B 7 is beyond the range of the oseilators, this 
value should sttl be induced in the table for calculation purposes (the 
MSB of B-7 would recuke a special software case, such as generating 
this bit in the CARRY before shifting). Each note nust be specif ed in p 
form which indicates wh ch of the 12 semitones is desired, end which of 
the eight octaves the semitone is in, Sirce four bits are necessary to 
select ] of 1 2 semitones and three bits a-e necessary ro select 1 of 8 
octaves, the information car fit in one hyte.. with the lower nybble select- 
ing the semitone (by addressing the look-up table) and the upper nybble 
being used by the divsion routine to determine how many times the 
table value must be right-shifted. 
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SID ENVELOPE GENERATORS 

The four-part ADSR (ATTACK, DECAY, SUSTAIN, RELEASE) envelope 
generator has been proven tn electronic music to provide the optimum 
trade off bctwq-qn flexibility and ease cf amplitude control. Appropriate 
selection of envelope parameters allows the simulation rvf a wide rnnge 
of percussion and sustained instruments. The violin is a good example of 
cf sustained insm-menr. The violinist controls the volume by bowing the 
instrument, Typically, tie volume builds slowly, reaches a peck, then 
d'ops to an intermediate level, The violinist can maintain this level for as 
long as desired, then the volume is allowed to slowly die away. A 
"snapshot" of this envelope is shown below: 



PEAK AMPLITUDE 



;ero amplitude 




This volume envelops can be easily reproduced by the ADSR as shown 
below, with typical envelope rates: 



ATTACK; io ($A) 

DECAY: 9 

surm:sV: i ($a) 

RELEASE: 9 



500 ms 
300 ms 

750 ms 



V 



A 



rl 



Note tlial the tone can be held al the intermediate SUSTAIN level -or 
as long as desirsd. The tone will not begin to die away untl GATE is 
cleared, Wilh minor alterations, this- basic envelope can be used for 
bress, and woodwinds as v/ell as strings. 

An enlirely different form of envelope is produced by percussion in- 
struments such as drums, cymbals and gongs, as well as certain 
keybourds such us pianos urid harpsichords. T J ie percussion envelope "s 
choracteri?ed by a needy instantaneous attack, immediately followed 
by a decay to zero volume, Percussion instruments cannot be sustained 
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□f a constant amplitude. For example, the instant a dam is struck,, the 
sound reaches full volume and decays rapidly reyurdless of how if was 
struck. A typical cymbal envelop? is shown below: 



ATTACK: 





2rns 


DECAY: 


9 


750rns 


SUSTAIN: 







RELEASE: 


9 


750ms 



Ncte that the rone immediately begins to decay to zero amp itude 
after the peak is reached, regardless of when GATE is cleared. The 
amplitude envelope of pianos and harpsichord* is somewhat more 
complicated, but can be generated quite easily with lie AD5R. These 
instruments reach full volume when a key is first struck. The amplitude 
immediately begins to die away slowly as lenci os the key remains de- 
pressed. If the key is released hefars the sound has fu \y died away, the 
amplitude will immediately drop tc zero. This envelope is shown be.ow: 



ATTACK: 





2 ms 


DECAY: 


9 


750 ms 


SUSTAIN: 







RELEASE; 





i> ms 



Note that the tone decays sbwiy until GATE is cleared, at which oolnt 
the amplftuce drops rapidly to zero. 

The most simple tinveiupe Is lliut of the uiyan, When a key s p r essed, 
the tone immediately reaches full volume end remans there. When the 
key is releosed, the tune drops immediately Id zero volume. This 
envelope is shown below: 



ATTACK: 





2 ms 


DECAY: 





6 ms 


SUSTAIN: 


15 (*F) 




RELEASE: 





6 ms 



C*1E 



L 



The real power of 51 D lies In the ability lt> create original sounds 
rather than simulations of acoustic instruments. The ADSR is capaole of 
crea'ing envelopes which do not corresoond ro any "real" instruments. A 
goad example would be the 'ofjekwards" envelope. This envelope is 
characterized by a slow attack and rapid decay which sounds very 
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much like or instrument that has been recorded on tape than played 
aackwafds. This envelope is ihown below: 



ATTACK: 10 l'$A] 500 ms 

DECAY: 6 ms 

SUS1AIN: 15I$F) 

RELEASE: 3 72 ms 



f 



■/ 



:wte 



Many unique sounds can he created by applying the amplitude 
enve'ope of one instrument to the harmonc structure of cnother. This 
produces sounds similar to fcmilinr ncoustic instruments, yet notably dif- 
ferent. In general, sound is quite subjective and experimentation with 
various envelope rotes nnd hnrmonrc content; will oe necessary in order 
to achieve the desired sound. 



n 
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3 
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u 
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TYPICAL SE81/SID APPLICATION 
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GLOSSARY 



ADSR 

attack 

binary 

Boolean operators 

byte 

CHROMA noise 

CIA 

DDR 

decay 

decimal 

e 

envelope 

FIFO 

hexadecimal 

integer 

jiffy clock 

NMI 

octal 

operand 

OS 

pixel 

queue 

register 

release 

ROM 

SID 

signed numbers 

subscript 

sustain 

syntax 

truncated 

VIC-II 

video screen 



Attack.'Deray/SustaWRelecise envelope. 

Rare ct w<hieh musical note recches peak 

voljme. 

Base-2 number system. 

Logical opercTsrs. 

Memory location. 

Color distortion. 

Complex Interface Adapter. 

Data Direction Register. 

Rate at which musical no + e falls from peak 

vol unit lu suityin volume, 

base-10 number system. 

MathemQtfcal constant (approx. 2.71828133). 

Shope of the volume ot a note over time. 

First-h/Fi-Jt-Out. 

Base-IA number system. 

Whole number (without decimal poini. 

Hardware interval timer. 

Non-Maskable Interrupt. 

Base-5 number system. 

Parameter. 

Operating System, 

Dot Q-f resolution on the screen. 

Sin ale-Hie line. 

special memory storage location. 

Ra\e at which a musical note falls from 

suitoin volume to no volume. 

Read-Only Memory, 

Sound Interface Device. 

Plus or minus numbers, 

Index variable. 

Volume level for sustain of musicol note. 

Programming sentence structure. 

Cut off, eliminated (nor rounced). 

Video Interface Chip. 

Television set. 
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Abbreviations. BASIC Commands., R-rte- 

iiibii i, urid Funcliona, i, 29. 31-34, 

37^-375 
ABS function, 31, 35. 374 
Accessories, 335-3? 1 
Acctmulotor, 213 
ACPTR, 272-2/4 
ADC, 232, 235, 254 
Addition, 3, 9 1 1 . 16 
Addressing. 211, 215-217. 411-413 
Aj'D/3/R, 183-165 13*, 196-199 
AND, 232, 236, 254 
AND opflrnlor, 13-16, SI, 35-36, 374 
Aimntlion, xiii. 153, 166 
Applications, xiii-KvE 
Arithmetic expressions, 10-12 
Arithmetic; operates, 10-12, 16 
Arrays, 10-" 2, .£4-45 
ASC fjnction, 31, 37, 374 
ASCII character «jde>, 31, 36, 340, 374 
ASL, 232, 236, 254 
Assembler, 215, 218, 227, 310 
AreToNjcnt fu-ittion, 31, 33, 374 
Attack, (see A/D/S/R) 

Bank selection, 101-102, 133 

BASir nhhr.viatiors, 29 31-34, 374-375 

BASIC commends, 3 '-34, 41 56-oC, 62. 

B1-3S, 91 
BASIC rwistel oneous functiam, 31-34, 

43-44, 49, 55-57, 61. 59, 70, SC, £3-85, 

89 
BASIC rumeric runet : an» p 31-35, 37-38, 42, 

46-47, 49, 83-84, £6-89 
BASIC operators, 3. 9 1 S, 31 36 43-64, 

68, V2 
BASIC 5ta1einsnte, 18-26, 31-34, 39-55, 57, 

62-67, 69-7?, 86-87, 02 
BASIC string furcrions. 31-34, jg, 56, 61, 

79, 87. B9 
BASIC \jririab&5, 7-26 
BCC, 232, 236. 254 
BCS, 232, 236, 254 
BFO, 22tV?27. 732. ?1? r »^4 
Bibliography, 389 -290 
Binary, 69, 92, I0E, 112, 216-217 
Bit. 99-140, 250, 398, 300-301, 305, 343- 

337, 359 
BIT, 232, 237, 251 
bit -nop mode, 121-130 
Bit Tiap made, multicolor, '27-13C 
Bit -napping, 121 130 
BAM, 232, 237, 254 
ENE, 226-527, 232, 238, 254 
Boolean aritirYic'ft, M 
EPL 232, 238, 254 
Eryi,tlies urid letting, 226-227 
BRK, 232, 236, 2S4 
Bufier, keyboard, 93 



Rnftine55 Clics. .lari-.wi 

BVC, 232, 239, 254 

BVS, 232, 239, 254 

Byte, 9, 104, 108, 117-11? 124-127, 196, 

213, 216-220, 222-227, ' 2*0-263, 2/4. 

273 277. 2B4, 292-293, 299, 307, 349, 

357-359 

Cacsette port, 337, 340-342 

Cassette, tn^e recorder, xiii, 39-41, 65-47, 

81-62. 91, 187, 192, 283 293-294 79/ 

320-321, 337-338, 340-342 
Cberarter PEEKs and POKEs. 104-, 1C6, 

109-111, 115, 113, 120-12^, 127-120, 

134-137, 150, 154-155, 159-161, 165- 

166 
CHAREN, 260-261 
CHKIN, 272-273, 275 
CHKOUI, 2/2-273, 27<S 
CHRGET, 272-273, 307-305 
CHRIN, 275-273, 277 278 
CHRQUI, 2/2-2/3, 278-279 
CIIE$ k'i*_ iun, 24, £1, 37-3E, J-i, 50, 55, 

75-76, 93-94, 97, T20, 156, 336 242, 

374, 379-381 
CINT, 272-273, 2E0 
CIOJT, 272-273, 279-280 
CLA.l, 272-273, 281 
CLC, 232, 239, 2£4 
CLD. 232, 94(1. 254 
CL , 232, 243. 254 
deck. 80, 89, 214, 329-332, 366, 406-408. 

421-427, 451, 451 
Clock riming diagram, 406-406 
CLOSE, 272-273, 221-282 
CLOSE slater-ient 31, 39-4', 343, 354, 374 
CLR sluternenl, 31, 39-4C, £1, 10?. 374 
CLBCHM, 272 273, 282 
CLR/HOWt ksy, 22C 
CLV, 232, 24C, 254 
CWiD siat»r-nnr. 31, 4 0-41. 374 
CMP, 232, 241, 25^ 
Collision cettct, 144-145, 'CO 
Color adjustment. 113 
Color co-nbirotions chart, 152 
Color memory. 1 03 

Cnbr register, 117, 120, 128. 1 35-7 36, 179 
Color screen, bockgrourd, border, 115- 

119, 128. 135 137, 176, I 79-' 60 
rnmmnm-k, RA5IC, 31-92 
Commodore magazine, xvii-sviii. 3VL 
C^miTicdore 64 memory mcip 310 
Complement, -uvos, 63-64 
Constants. floalnq-pofnT. integer, string, 

± 7, 46, 77-73 
COMTnue command, 31. 41-42, 44, 31 , 

66, 374 
ConTRoL key, 58, 72, 9S-97, 171 
COSine tunrtinn, 31-34, 42, 374 
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CK/M, x, xiv, 365-3/1 

CPX, 227, 232, 24', 254 

CPY, 327, 232, 241, 25-1 

Crunching BASIC programs, 24-27. lie 

CuRSuR keys, 92-97, 336 

DAIASiEirF 7 " r&trnrder, (see cassette, 

tape recorder} 
DATA etate/nent, 26. 31, 42-43, 76-77, 

1 11-114, 164, 169, 174, 3« 
DEC, 232, 242, 254 
Decay, [sea AJOIS/ti) 

OEFne FuNct on stoTtenent J I . 43-44. 37.-: 
DELcie key, 71-72, 95-?£ 
DEX, 226, 232, 242, 254 
DET, 226, 232, 242, 254 
Dl.Wsiiiiun solemisiil, 9, 31, 44-45, 374 
Dif^ef medta, 3 
Division, 3, 10-11 

Edit mode-, 93-97 
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Modem, xlll-xvllt, 339-340 
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Regis-er map, CIA -Kip, 428 
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EEC, 235, 250, 255 

SCNKEY, 273, 295 

SCREEN, 273 2?5-29(i 



IUDEX 



433 



Screen editor, 2, 94-97, 21 I 
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ABOUT TIIE COMMODORE 64 
PROGRAMMER'S REFERENCE 
GUIDE • . . 



Game cartridge compatibility .'. . spectacular sound , . , arcade 
style graphics , , , arid high caliber computing capabilities make 
the Commodore 64 the most advanced personal computer in 
its class for home, business and educational use, 

The COMMODORE 6+ PROGRAMMER'S REFERENCE GUIDE tells 

you everything you need to know about your Commodore 6+. 
The perfect companion to your Commodore 64 User's Gu-de, 
this manual presents detailed information on everything from 
graphics and sound to advanced machine language 
techniques. This book is a must for everyone from the beginner 
to the advanced programmer. 

Far the besinner, the most complicated topics are explained 
with many sample programs and an easy-to-read writing style. 
For the advanced programmer, tnis book has seen subjected 
to heavy pre-testin3 with your needs in mind. And it's 
designed so that you can easily get the most out of your 
Commodore 64- s extensive capabilities. 
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